MessageQueueInstaller.Install(IDictionary) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Realiza a instalação e escreve a informação da fila de mensagens no registo. 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
A IDictionary era usado para guardar a informação necessária para realizar um commit, reverter ou desinstalar.
Observações
O Install método escreve a informação da fila de mensagens no registo e associa a MessageQueue instância a uma fila localizada no caminho especificado pela Path propriedade. Se a fila ainda não existir, Install cria-se uma fila transacional. Install define as propriedades da fila novas ou existentes para aquelas que especificou no MessageQueueInstallerarquivo . Se a fila já existir, as suas propriedades são redefinidas para as do MessageQueueInstaller. Se a fila existente não for transacional, é eliminada e depois recriada como fila transacional.
Atenção
Se for necessário recriar a fila, as mensagens na fila serão perdidas.
Normalmente, não chamas os métodos MessageQueueInstaller do from dentro do teu código; geralmente são chamados apenas pela utilidade de instalação installutil.exe. A ferramenta chama automaticamente o Install método durante o processo de instalação para escrever a informação do registo associada à fila de mensagens que está a ser instalada. A instalação é transacional, por isso, se houver uma falha de qualquer componente do projeto de instalação durante a instalação, todos os componentes previamente instalados são revertidos aos seus estados pré-instalação. Isto é conseguido 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, a empresa de instalação compromete as instalações. Commit completa a instalação do MessageQueue definindo a fila para o estado inicial apropriado. Se a fila especificada pela Path propriedade já existir e contiver mensagens, Commit limpa as mensagens. Commit, em vez de Install, limpa as mensagens porque o ato de purgar as mensagens não pode ser revertido.
A rotina de instalação de uma aplicação utiliza a do instalador Installer.Context do projeto para manter automaticamente informação sobre os componentes que já foram instalados. Esta informação de estado, que é passada como InstallstateSaver parâmetro, é continuamente atualizada à medida que a utilidade instala cada MessageQueueInstaller instância. Normalmente, não é necessário que o seu código modifique explicitamente esta informação de estado.