Compartilhar via

MessageQueueInstaller.Install(IDictionary) Método

  • Referência

Definição

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

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 -> unit
Public 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.

Aplica-se a

Confira também