MessageQueueInstaller Třída

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Umožňuje nainstalovat a nakonfigurovat frontu, kterou vaše aplikace potřebuje ke spuštění. Tato třída je volána instalačním nástrojem, například InstallUtil.exe, při instalaci 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

Dědičnost

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Poznámky

Instalační MessageQueueInstaller nástroj slouží k zápisu hodnot registru přidružených k frontě. Další informace o instalačních nástroji najdete v tématu Installutil.exe (instalační nástroj).

Chcete-li nainstalovat frontu, vytvořte třídu instalačního programu projektu, která dědí z objektu Installer, a nastavte RunInstallerAttribute třídu na true. V rámci projektu vytvořte MessageQueueInstaller instanci pro každou frontu v instalaci a přidejte instanci do třídy instalačního programu projektu.

Při vytváření MessageQueueInstaller instance můžete konstruktoru volitelně předat existující MessageQueue (například z testovacího serveru).MessageQueueInstaller Tento přístup automaticky poskytuje nastavení konfigurace pro novou frontu zrcadlením nastavení předané fronty. Alternativně můžete vlastnosti v MessageQueueInstaller instanci nastavit na požadované stavy a volat konstruktor bez parametrů.

Když je volána instalační nástroj, hledá RunInstallerAttribute. Pokud ano true, nástroj nainstaluje všechny fronty v Installers kolekci přidružené k instalačnímu programu projektu. Pokud RunInstallerAttribute ano false, nástroj ignoruje instalační program projektu.

Jiné vlastnosti MessageQueueInstaller instance můžete upravit před nebo po přidání instance do Installers kolekce instalačního programu projektu. Fronta Path musí být například nastavená před spuštěním instalačního nástroje.

Obvykle nevoláte metody MessageQueueInstaller z kódu; obvykle jsou volána pouze instalačním nástrojem installutil.exe. Nástroj automaticky volá metodu Install během procesu instalace a volání Commit , pokud instalace nevyvolala výjimku. V případě potřeby vyvrátí selhání voláním Rollback objektu, který vygeneroval výjimku.

Instalační rutina aplikace používá instalační program Installer.Context projektu k automatické údržbě informací o komponentách, které už byly nainstalovány. Tyto informace o stavu se průběžně aktualizují, protože jednotlivé MessageQueueInstaller instance jsou nainstalovány nástrojem. Kód obvykle nemusí explicitně upravovat informace o stavu.

Konstruktory

Name	Description
MessageQueueInstaller()	Inicializuje novou instanci MessageQueueInstaller třídy. Nenastavuje žádné vlastnosti instance.
MessageQueueInstaller(MessageQueue)	Inicializuje novou instanci MessageQueueInstaller třídy a inicializuje nastavení instalace na existující MessageQueue instanci.

Vlastnosti

Name	Description
Authenticate	Získá nebo nastaví hodnotu, která označuje, zda fronta, která má být nainstalována přijímá pouze ověřené zprávy.
BasePriority	Získá nebo nastaví základní prioritu, která se používá ke směrování zpráv veřejné fronty přes síť.
CanRaiseEvents	Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component)
Category	Získá nebo nastaví typ fronty specifické pro implementaci.
Container	Získá ten IContainer , který obsahuje Component. (Zděděno od Component)
Context	Získá nebo nastaví informace o aktuální instalaci. (Zděděno od Installer)
DesignMode	Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (Zděděno od Component)
EncryptionRequired	Získá nebo nastaví hodnotu, která označuje, zda fronta přijímá pouze soukromé nebo šifrované zprávy.
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
HelpText	Získá text nápovědy pro všechny instalační programy v kolekci instalačního programu. (Zděděno od Installer)
Installers	Získá kolekci instalačních programů, které tento instalační program obsahuje. (Zděděno od Installer)
Label	Získá nebo nastaví popis fronty.
MaximumJournalSize	Získá nebo nastaví maximální velikost deníku, který je přidružen k frontě.
MaximumQueueSize	Získá nebo nastaví maximální velikost fronty.
MulticastAddress	Zavedeno v MSMQ 3.0. Získá nebo nastaví adresu vícesměrového vysílání přidružené k frontě.
Parent	Získá nebo nastaví instalační program obsahující kolekci, do které tento instalační program patří. (Zděděno od Installer)
Path	Získá nebo nastaví umístění fronty, na kterou odkazuje tento objekt.
Permissions	Získá nebo nastaví oprávnění přidružená k frontě.
Site	Získá nebo nastaví ISite objektu Component. (Zděděno od Component)
Transactional	Získá nebo nastaví hodnotu, která označuje, zda fronta přijímá pouze zprávy odeslané jako součást transakce.
UninstallAction	Získá nebo nastaví hodnotu, která indikuje, co instalační program dělá s frontou v době odinstalace: odebere ji, obnoví do stavu předinstalací nebo ji ponechá v aktuálním stavu nainstalované.
UseJournalQueue	Získá nebo nastaví hodnotu, která označuje, zda zprávy načtené z fronty jsou také zkopírovány do přidružené fronty deníku.

Metody

Name	Description
Commit(IDictionary)	Dokončí proces instalace potvrzením informací o MessageQueue instalaci, které Install(IDictionary) metoda napsala do registru. Tato metoda je určena k použití instalačními nástroji, které automaticky volají příslušné metody.
CopyFromComponent(IComponent)	Zkopíruje hodnoty MessageQueue vlastností komponenty, které jsou vyžadovány v době instalace fronty zpráv.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané Component a volitelně uvolní spravované prostředky. (Zděděno od Component)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Install(IDictionary)	Provede instalaci a zapíše informace fronty zpráv do registru. Tato metoda je určena k použití instalačními nástroji, které automaticky volají příslušné metody.
IsEquivalentInstaller(ComponentInstaller)	Určuje, zda zadaný instalační program dokáže zpracovat stejný druh instalace jako tento instalační program.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnAfterInstall(IDictionary)	AfterInstall Vyvolá událost. (Zděděno od Installer)
OnAfterRollback(IDictionary)	AfterRollback Vyvolá událost. (Zděděno od Installer)
OnAfterUninstall(IDictionary)	AfterUninstall Vyvolá událost. (Zděděno od Installer)
OnBeforeInstall(IDictionary)	BeforeInstall Vyvolá událost. (Zděděno od Installer)
OnBeforeRollback(IDictionary)	BeforeRollback Vyvolá událost. (Zděděno od Installer)
OnBeforeUninstall(IDictionary)	BeforeUninstall Vyvolá událost. (Zděděno od Installer)
OnCommitted(IDictionary)	Committed Vyvolá událost. (Zděděno od Installer)
OnCommitting(IDictionary)	Committing Vyvolá událost. (Zděděno od Installer)
Rollback(IDictionary)	Obnoví počítač do stavu, ve který byl před instalací, vrácením informací fronty, které instalační postup napsal do registru. Tato metoda je určena k použití instalačními nástroji, které automaticky volají příslušné metody.
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)
Uninstall(IDictionary)	Odebere instalaci odebráním informací o frontě z registru. Tato metoda je určena k použití odinstalačními nástroji, které automaticky volají příslušné metody.

Událost

Name	Description
AfterInstall	Nastane po Install(IDictionary) spuštění metod všech instalačních programů ve Installers vlastnosti. (Zděděno od Installer)
AfterRollback	Nastane po instalaci všech instalačních programů ve Installers vlastnosti se vrátí zpět. (Zděděno od Installer)
AfterUninstall	Nastane po všech instalačních programech ve Installers vlastnosti provádět své operace odinstalace. (Zděděno od Installer)
BeforeInstall	Nastane před spuštěním Install(IDictionary) metody každého instalačního programu v kolekci instalačního programu. (Zděděno od Installer)
BeforeRollback	Nastane před vrácením instalačních programů ve Installers vlastnosti. (Zděděno od Installer)
BeforeUninstall	Nastane dříve, než instalační programy ve Installers vlastnosti provádějí své operace odinstalace. (Zděděno od Installer)
Committed	Nastane po potvrzení všech instalačních programů ve Installers vlastnosti jejich instalace. (Zděděno od Installer)
Committing	Nastane před instalačními programy ve Installers vlastnosti potvrdí jejich instalace. (Zděděno od Installer)
Disposed	Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component)

Viz také

• Installutil.exe (instalační nástroj)