MessageQueueInstaller Classe
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.
Permite-te instalar e configurar uma fila que a tua aplicação precisa para correr. Esta classe é chamada pela utilidade 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
Observações
É MessageQueueInstaller usado pela utilidade de instalação para escrever valores de registo associados à fila. Para mais informações sobre utilidades de instalação, consulte Installutil.exe (Ferramenta de Instalação).
Para instalar uma fila, crie uma classe de instalador de projeto que herde do Installer, e defina para RunInstallerAttribute a classe para true. Dentro do seu projeto, crie uma MessageQueueInstaller instância para cada fila na instalação e adicione a instância à sua classe instaladora do projeto.
Ao criar uma MessageQueueInstaller instância, pode, opcionalmente, passar uma existente MessageQueue (por exemplo, de um servidor de teste) para o MessageQueueInstaller construtor. Esta abordagem fornece automaticamente as definições de configuração para a nova fila, espelhando as definições da fila passada. Alternativamente, podes definir manualmente as propriedades na MessageQueueInstaller instância para os estados que queres e chamar o construtor sem parâmetros.
Quando a utilidade de instalação é chamada, procura o RunInstallerAttribute. Se for true, a utilitária instala todas as filas na Installers coleção associada ao instalador do seu projeto. Se RunInstallerAttribute for false, a utilidade ignora o instalador do projeto.
Modifica outras propriedades de uma MessageQueueInstaller instância antes ou depois de adicionar a instância à Installers coleção do instalador do seu projeto. Por exemplo, uma fila Path deve ser definida antes de a utilidade de instalação ser executada.
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 utilidade chama automaticamente o Install método durante o processo de instalação e chama Commit se a instalação não tiver lançado uma exceção. Recua as falhas, se necessário, ao chamar Rollback o objeto que gerou a exceção.
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 é continuamente atualizada à medida que cada MessageQueueInstaller instância é instalada pela empresa. Normalmente não é necessário que o seu código modifique explicitamente a informação do estado.
Construtores
| Name | Description |
|---|---|
| MessageQueueInstaller() |
Inicializa uma nova instância da MessageQueueInstaller classe. Não define nenhuma propriedade de instância. |
| MessageQueueInstaller(MessageQueue) |
Inicializa uma nova instância da MessageQueueInstaller classe, inicializando as definições de instalação para as de uma instância existente MessageQueue . |
Propriedades
| Name | Description |
|---|---|
| Authenticate |
Recebe ou define um valor que indica se a fila a instalar aceita apenas mensagens autenticadas. |
| BasePriority |
Recebe ou define a prioridade base que é usada para encaminhar as 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 definem um tipo de fila específico para a 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á atualmente em modo de design. (Herdado de Component) |
| EncryptionRequired |
Recebe ou define um valor que indica se a fila aceita apenas mensagens privadas ou encriptadas. |
| Events |
Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component) |
| HelpText |
Recebe o texto de ajuda para todos os instaladores na coleção de instaladores. (Herdado de Installer) |
| Installers |
Fica com a coleção de instaladores que este instalador contém. (Herdado de Installer) |
| Label |
Recebe 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 a que este instalador pertence. (Herdado de Installer) |
| Path |
Obtém ou define a localização da fila que é referenciada por este objeto. |
| Permissions |
Obtém ou definem permissões associadas à fila. |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
| Transactional |
Recebe ou define um valor que indica se a fila aceita apenas mensagens enviadas como parte de uma transação. |
| UninstallAction |
Recebe ou define um valor que indica o que o instalador faz com a fila na altura da desinstalação: removê-lo, restaurá-lo ao estado pré-instalação ou mantê-lo no estado atual de instalação. |
| UseJournalQueue |
Recebe 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
| Name | Description |
|---|---|
| Commit(IDictionary) |
Conclui o processo de instalação ao comprometer a MessageQueue informação de instalação que o Install(IDictionary) método escreveu para o registo. 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 das propriedades de um MessageQueue componente que são necessários na fase de instalação para uma fila de mensagens. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Liberta todos os recursos utilizados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos. (Herdado de Component) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetService(Type) |
Devolve 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-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| Install(IDictionary) |
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. |
| IsEquivalentInstaller(ComponentInstaller) |
Determina se o instalador especificado consegue gerir o mesmo tipo de instalação que este instalador. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| OnAfterInstall(IDictionary) |
Eleva o AfterInstall evento. (Herdado de Installer) |
| OnAfterRollback(IDictionary) |
Eleva o AfterRollback evento. (Herdado de Installer) |
| OnAfterUninstall(IDictionary) |
Eleva o AfterUninstall evento. (Herdado de Installer) |
| OnBeforeInstall(IDictionary) |
Eleva o BeforeInstall evento. (Herdado de Installer) |
| OnBeforeRollback(IDictionary) |
Eleva o BeforeRollback evento. (Herdado de Installer) |
| OnBeforeUninstall(IDictionary) |
Eleva o BeforeUninstall evento. (Herdado de Installer) |
| OnCommitted(IDictionary) |
Eleva o Committed evento. (Herdado de Installer) |
| OnCommitting(IDictionary) |
Eleva o Committing evento. (Herdado de Installer) |
| Rollback(IDictionary) |
Restaura o computador ao estado em que estava antes da instalação, revertendo a informação da fila que o procedimento de instalação escreveu para o registo. Este método destina-se a ser usado por ferramentas de instalação, que chamam automaticamente os métodos apropriados. |
| ToString() |
Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de Component) |
| Uninstall(IDictionary) |
Remove uma instalação removendo a informação da fila do registo. Este método destina-se a ser usado por ferramentas de desinstalação, que chamam automaticamente os métodos apropriados. |
evento
| Name | Description |
|---|---|
| AfterInstall |
Acontece depois de os Install(IDictionary) métodos de todos os instaladores da Installers propriedade terem sido executados. (Herdado de Installer) |
| AfterRollback |
Acontece depois de as instalações de todos os instaladores Installers na propriedade serem revertidas. (Herdado de Installer) |
| AfterUninstall |
Ocorre depois de todos os instaladores da propriedade realizarem Installers as operações de desinstalação. (Herdado de Installer) |
| BeforeInstall |
Ocorre antes de o Install(IDictionary) método de cada instalador na coleção de instaladores ter sido executado. (Herdado de Installer) |
| BeforeRollback |
Acontece antes de os instaladores Installers da propriedade serem recuados. (Herdado de Installer) |
| BeforeUninstall |
Ocorre antes de os instaladores Installers da propriedade realizarem as operações de desinstalação. (Herdado de Installer) |
| Committed |
Acontece depois de todos os instaladores Installers da propriedade terem concluído as suas instalações. (Herdado de Installer) |
| Committing |
Ocorre antes de os instaladores Installers da propriedade realizarem as instalações. (Herdado de Installer) |
| Disposed |
Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component) |