MessageQueueInstaller Classe

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Permite que você instale e configure uma fila de que seu aplicativo precisa para ser executado. Essa classe é chamada pelo utilitário de instalação, por exemplo, InstallUtil.exe, ao instalar um MessageQueue.

public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstaller

public class MessageQueueInstaller : System.Configuration.Install.ComponentInstaller

type MessageQueueInstaller = class
    inherit ComponentInstaller

Public Class MessageQueueInstaller
Inherits ComponentInstaller

Herança

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Comentários

O MessageQueueInstaller é usado pelo utilitário de instalação para gravar valores de registro associados à fila. Para obter mais informações sobre utilitários de instalação, consulte Installutil.exe (Ferramenta Instalador).

Para instalar uma fila, crie uma classe de instalador de projeto que herda do Installere defina o RunInstallerAttribute para a classe como true. No projeto, crie uma MessageQueueInstaller instância para cada fila na instalação e adicione a instância à classe do instalador do projeto.

Ao criar uma MessageQueueInstaller instância, opcionalmente, você pode passar um existente MessageQueue (por exemplo, de um servidor de teste) para o MessageQueueInstaller construtor. Essa abordagem fornece automaticamente as definições de configuração para a nova fila espelhando as configurações da fila passada. Como alternativa, você pode definir manualmente as propriedades na MessageQueueInstaller instância para os estados desejados e chamar o construtor sem parâmetros.

Quando o utilitário de instalação é chamado, ele procura o RunInstallerAttribute. Se for true, o utilitário instalará todas as filas na Installers coleção associada ao instalador do projeto. Se RunInstallerAttribute for false, o utilitário ignorará o instalador do projeto.

Modifique outras propriedades de uma MessageQueueInstaller instância antes ou depois de adicionar a instância à Installers coleção do instalador do projeto. Por exemplo, uma fila deve ser definida antes da Path execução do utilitário de instalação.

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 chamará automaticamente o Install método durante o processo de instalação e chamará Commit se a instalação não tiver gerado uma exceção. Ele faz backup de falhas, se necessário, chamando Rollback o objeto que gerou a exceção.

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 são atualizadas continuamente à medida que cada MessageQueueInstaller instância é instalada pelo utilitário . Normalmente, não é necessário que seu código modifique explicitamente as informações de estado.

Construtores

MessageQueueInstaller()	Inicializa uma nova instância da classe MessageQueueInstaller. Não define nenhuma propriedade de instância.
MessageQueueInstaller(MessageQueue)	Inicializa uma nova instância da classe MessageQueueInstaller inicializando as configurações de instalação para aquelas de uma instância MessageQueue existente.

Propriedades

Authenticate	Obtém ou define um valor que indica se a fila a ser instalado aceita apenas mensagens autenticadas.
BasePriority	Obtém ou define a prioridade base usada para rotear mensagens de uma fila pública pela rede.
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
Category	Obtém ou define um tipo de fila específico da implementação.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
Context	Obtém ou define informações sobre a instalação atual. (Herdado de Installer)
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
EncryptionRequired	Obtém ou define um valor que indica se a fila aceita apenas mensagens privadas ou criptografadas.
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
HelpText	Obtém o texto de ajuda para todos os instaladores na coleção de instalador. (Herdado de Installer)
Installers	Obtém a coleção de instaladores que contém esse instalador. (Herdado de Installer)
Label	Obtém ou define uma descrição da fila.
MaximumJournalSize	Obtém ou define o tamanho máximo do diário associado à fila.
MaximumQueueSize	Obtém ou define o tamanho máximo da fila.
MulticastAddress	Introduzido no MSMQ 3.0. Obtém ou define o endereço multicast associado à fila.
Parent	Obtém ou define o instalador que contém a coleção à qual o instalador pertence. (Herdado de Installer)
Path	Obtém ou define o local da fila referenciada por este objeto.
Permissions	Obtém ou define as permissões associadas à fila.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
Transactional	Obtém ou define um valor que indica se a fila aceita apenas mensagens enviadas como parte de uma transação.
UninstallAction	Obtém ou define um valor que indica o que o instalador faz com a fila no momento da desinstalação: remove, restaura para o estado pré-instalação ou deixa no estado atual instalado.
UseJournalQueue	Obtém ou define um valor que indica se as mensagens recuperadas da fila também são copiadas para a fila de diário associada.

Métodos

Commit(IDictionary)	Conclui o processo de instalação confirmando as informações de instalação MessageQueue que o método Install(IDictionary) gravou no registro. Este método destina-se a ser usado por ferramentas de instalação, que chamam automaticamente os métodos apropriados.
CopyFromComponent(IComponent)	Copia os valores de propriedade de um componente MessageQueue que são necessários no momento da instalação para uma fila de mensagens.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
Install(IDictionary)	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.
IsEquivalentInstaller(ComponentInstaller)	Determina se o instalador especificado pode lidar com o mesmo tipo de instalação que esse instalador.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnAfterInstall(IDictionary)	Aciona o evento AfterInstall. (Herdado de Installer)
OnAfterRollback(IDictionary)	Aciona o evento AfterRollback. (Herdado de Installer)
OnAfterUninstall(IDictionary)	Aciona o evento AfterUninstall. (Herdado de Installer)
OnBeforeInstall(IDictionary)	Aciona o evento BeforeInstall. (Herdado de Installer)
OnBeforeRollback(IDictionary)	Aciona o evento BeforeRollback. (Herdado de Installer)
OnBeforeUninstall(IDictionary)	Aciona o evento BeforeUninstall. (Herdado de Installer)
OnCommitted(IDictionary)	Aciona o evento Committed. (Herdado de Installer)
OnCommitting(IDictionary)	Aciona o evento Committing. (Herdado de Installer)
Rollback(IDictionary)	Restaura o computador para o estado em que estava antes da instalação revertendo as informações de fila que o procedimento de instalação gravou no registro. Este método destina-se a ser usado por ferramentas de instalação, que chamam automaticamente os métodos apropriados.
ToString()	Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)
Uninstall(IDictionary)	Remove uma instalação removendo as informações de fila do registro. Este método destina-se a ser usado por ferramentas de desinstalação, que chamam automaticamente os métodos apropriados.

Eventos

AfterInstall	Ocorre depois que os métodos do Install(IDictionary) de todos os instaladores na propriedade Installers foram executados. (Herdado de Installer)
AfterRollback	Ocorre após as instalações de todos os instaladores na propriedade Installers serem revertidas. (Herdado de Installer)
AfterUninstall	Ocorre depois que todos os instaladores na propriedade Installers realizam suas operações de desinstalação. (Herdado de Installer)
BeforeInstall	Ocorre antes do método Install(IDictionary) de cada instalador no instalador em que a coleção foi executada. (Herdado de Installer)
BeforeRollback	Ocorre antes que os instaladores na propriedade Installers sejam revertidos. (Herdado de Installer)
BeforeUninstall	Ocorre antes dos instaladores na propriedade Installers executarem suas operações de desinstalação. (Herdado de Installer)
Committed	Ocorre depois que todos os instaladores na propriedade Installers confirmaram suas instalações. (Herdado de Installer)
Committing	Ocorre antes que os instaladores na propriedade Installers façam commit de suas instalações. (Herdado de Installer)
Disposed	Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)

Confira também

• Installutil.exe (Ferramenta de Instalação)