MessageQueueInstaller Classe

  • Referência

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()
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)

Aplica-se a

Confira também