MessageQueueInstaller.Install(IDictionary) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Executa a instalação e grava as informações de fila de mensagens no registro. Este método destina-se a ser usado por ferramentas de instalação, que chamam automaticamente os métodos apropriados.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install (System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Parâmetros
- stateSaver
- IDictionary
Um IDictionary usado para salvar as informações necessárias para executar uma operação de confirmar, reverter ou desinstalar.
Comentários
O Install método grava informações da fila de mensagens no registro e associa a instância a MessageQueue uma fila localizada no caminho especificado pela Path propriedade . Se a fila ainda não existir, Install criará uma fila transacional. Install define as propriedades de fila novas ou existentes para aquelas que você especificou no MessageQueueInstaller. Se a fila já existir, suas propriedades serão redefinidas para as MessageQueueInstallerdo . Se a fila existente não for transacional, ela será excluída e recriada como uma fila transacional.
Cuidado
Se for necessário recriar a fila, as mensagens na fila serão perdidas.
Normalmente, você não chama os métodos do de dentro de MessageQueueInstaller seu código; eles geralmente são chamados apenas pelo utilitário de instalação installutil.exe. O utilitário chama automaticamente o Install método durante o processo de instalação para gravar informações do Registro associadas à fila de mensagens que está sendo instalada. A instalação é transacional, portanto, se houver uma falha de qualquer componente do projeto de instalação durante a instalação, todos os componentes instalados anteriormente serão revertidos para seus estados de pré-instalação. Isso é feito chamando o método de Rollback cada componente.
Após a instalação bem-sucedida de todos os componentes associados ao projeto de instalação, o utilitário de instalação confirma as instalações. Commit conclui a instalação do MessageQueue definindo a fila como o estado inicial apropriado. Se a fila especificada pela Path propriedade já existir e contiver mensagens, Commit limpará as mensagens. Commit, em vez de Install, limpa as mensagens porque o ato de limpar as mensagens não pode ser revertido.
A rotina de instalação de um aplicativo usa o do instalador do Installer.Context projeto para manter automaticamente informações sobre os componentes que já foram instalados. Essas informações de estado, que são passadas para Install como o stateSaver parâmetro , são atualizadas continuamente à medida que o utilitário instala cada MessageQueueInstaller instância. Normalmente, não é necessário que seu código modifique explicitamente essas informações de estado.
