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

Je MessageQueueInstaller používán instalačním nástrojem k zápisu hodnot registru, které jsou přidruženy k frontě. Další informace o instalačních nástrojech najdete v tématu Installutil.exe (instalační nástroj).

Pokud chcete nainstalovat frontu, vytvořte třídu instalačního programu projektu, která dědí z objektu Installer, a nastavte RunInstallerAttribute pro 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 MessageQueueInstaller serveru). Tento přístup automaticky poskytuje nastavení konfigurace nové fronty zrcadlení nastavení předané fronty. Alternativně můžete ručně nastavit vlastnosti v MessageQueueInstaller instanci na požadované stavy a volat konstruktor bez parametrů.

Při zavolání instalačního nástroje vyhledá RunInstallerAttribute. Pokud je true, nástroj nainstaluje všechny fronty v kolekci Installers přidružené k instalačnímu programu projektu. Pokud RunInstallerAttribute je false, nástroj ignoruje instalační program projektu.

Můžete upravit další vlastnosti MessageQueueInstaller instance před nebo po přidání instance do Installers kolekce instalačního programu projektu. Například fronta Path musí být nastavena před spuštěním instalačního nástroje.

Obvykle nevoláte metody MessageQueueInstaller z vašeho kódu; jsou obecně volána pouze installutil.exe instalačním nástrojem. Nástroj automaticky volá metodu Install během procesu instalace a volá, Commit pokud instalace nevyvolala výjimku. V případě potřeby zatěžuje 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é již byly nainstalovány. Tyto informace o stavu se průběžně aktualizují, protože nástroj instaluje každou MessageQueueInstaller instanci. Obvykle není nutné, aby váš kód explicitně upravil informace o stavu.

Konstruktory

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

Vlastnosti

Authenticate	Získá nebo nastaví hodnotu, která označuje, zda fronta k instalaci 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 označ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á objekt 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 je aktuálně v režimu návrhu Component . (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ženou k frontě.
Parent	Získá nebo nastaví instalační program obsahující kolekci, do které patří tento instalační program. (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 z 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á označuje, co instalační program provede s frontou při odinstalaci: odeberte jej, obnovte jej do předinstalačního stavu nebo jej ponechejte v aktuálním nainstalovaném stavu.
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

Commit(IDictionary)	Dokončí proces instalace potvrzením informací o MessageQueue instalaci, které Install(IDictionary) metoda zapisuje 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í součásti, které jsou požadovány v době instalace pro frontu zpráv.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící 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é nástrojem Component a volitelně uvolní spravované prostředky. (Zděděno od Component)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte aktuální životnost objektu služby, 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 .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Install(IDictionary)	Provede instalaci a zapíše informace o frontě 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 může zpracovat stejný typ instalace jako tento instalační program.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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, v jakém byl před instalací, vrácením informací o frontě, které postup instalace zapsal 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 , Componentpokud 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í nástroje, které automaticky volají příslušné metody.

Událost

AfterInstall	Vyvolá se Install(IDictionary) po spuštění metod všech instalačních programů ve Installers vlastnosti . (Zděděno od Installer)
AfterRollback	Vyvolá se po vrácení instalací všech instalačních programů ve Installers vlastnosti zpět. (Zděděno od Installer)
AfterUninstall	Vyvolá se poté, co všechny instalační programy ve Installers vlastnosti provedou 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 zpět. (Zděděno od Installer)
BeforeUninstall	Nastane předtím, než instalační programy ve Installers vlastnosti provedou své operace odinstalace. (Zděděno od Installer)
Committed	Vyvolá se poté, co všechny instalační programy ve Installers vlastnosti potvrdily své instalace. (Zděděno od Installer)
Committing	Nastane předtím, než instalační programy ve Installers vlastnosti potvrdí své instalace. (Zděděno od Installer)
Disposed	Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)

Viz také

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