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 utilitário de instalação é usado para gravar valores do Registro associados à fila. Para obter mais informações sobre utilitários de instalação, consulte Installutil.exe (Ferramenta do Instalador).

Para instalar uma fila, crie uma classe de instalador de projeto que herda do Installere defina a RunInstallerAttribute classe truecomo . Em seu projeto, crie uma MessageQueueInstaller instância para cada fila na instalação e adicione a instância à classe do instalador de 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 configurações da 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 estiver 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 execução do Path utilitário de instalação.

Normalmente, você não chama os métodos de dentro do MessageQueueInstaller 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 e chama Commit se a instalação não gerou 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 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 o código modifique explicitamente as informações de estado.

Construtores

Nome Description
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 MessageQueueInstaller classe, inicializando as configurações de instalação para as de uma instância existente MessageQueue .

Propriedades

Nome Description
Authenticate

Obtém ou define um valor que indica se a fila a ser instalada 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 gerar um evento.

(Herdado de Component)
Category

Obtém ou define um tipo de fila específico à 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 anexados a isso Component.

(Herdado de Component)
HelpText

Obtém o texto de ajuda para todos os instaladores na coleção do instalador.

(Herdado de Installer)
Installers

Obtém a coleção de instaladores que este instalador contém.

(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 este instalador pertence.

(Herdado de Installer)
Path

Obtém ou define o local da fila referenciada por esse objeto.
Permissions

Obtém ou define 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: remova-o, restaure-o para seu estado de pré-instalação ou deixe-o em seu 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ários associada.

Métodos

Nome Description
Commit(IDictionary)

Conclui o processo de instalação confirmando as MessageQueue informações de instalação que o Install(IDictionary) método escreveu no registro. Esse método deve ser usado por ferramentas de instalação, que chamam automaticamente os métodos apropriados.
CopyFromComponent(IComponent)

Copia os valores de propriedade de um MessageQueue componente que são necessários no momento da instalação de 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 hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância.

(Herdado de MarshalByRefObject)
GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou por sua 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 dessa instância.

(Herdado de MarshalByRefObject)
Install(IDictionary)

Executa a instalação e grava informações da fila de mensagens no registro. Esse método deve 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 Objectatual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(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 da fila que o procedimento de instalação escreveu ao registro. Esse método deve 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 informações de fila do registro. Esse método deve ser usado por ferramentas de desinstalação, que chamam automaticamente os métodos apropriados.

Eventos

Nome Description
AfterInstall

Ocorre depois que os Install(IDictionary) métodos de todos os instaladores na Installers propriedade são executados.

(Herdado de Installer)
AfterRollback

Ocorre depois que as instalações de todos os instaladores na Installers propriedade são revertidas.

(Herdado de Installer)
AfterUninstall

Ocorre depois que todos os instaladores na Installers propriedade executam suas operações de desinstalação.

(Herdado de Installer)
BeforeInstall

Ocorre antes da execução do Install(IDictionary) método de cada instalador na coleção do instalador.

(Herdado de Installer)
BeforeRollback

Ocorre antes que os instaladores na Installers propriedade sejam revertidos.

(Herdado de Installer)
BeforeUninstall

Ocorre antes que os instaladores na Installers propriedade executem suas operações de desinstalação.

(Herdado de Installer)
Committed

Ocorre depois que todos os instaladores na Installers propriedade confirmam suas instalações.

(Herdado de Installer)
Committing

Ocorre antes que os instaladores na Installers propriedade confirmem suas instalações.

(Herdado de Installer)
Disposed

Ocorre quando o componente é descartado por uma chamada para o Dispose() método.

(Herdado de Component)

Aplica-se a

Confira também