MessageQueueInstaller Classe
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.
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::ComponentInstallerpublic class MessageQueueInstaller : System.Configuration.Install.ComponentInstallertype MessageQueueInstaller = class
inherit ComponentInstallerPublic Class MessageQueueInstaller
Inherits ComponentInstaller- Herança
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() |
Obsoleto.
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() |
Obsoleto.
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) |
