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 informações da fila de mensagens no registro. Esse método deve 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 confirmação, reversão ou desinstalação.
Comentários
O Install método grava informações da fila de mensagens no registro e associa a MessageQueue instância a 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 as 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 de dentro do MessageQueueInstaller 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 em 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 da configuração da MessageQueue fila para o estado inicial apropriado. Se a fila especificada pela Path propriedade já existir e contiver mensagens, Commit desmarque as mensagens. CommitEm vez disso 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 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 como o stateSaver parâmetro, são atualizadas continuamente à Install 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.
