MessageQueueInstaller Osztály

Definíció

Névtér:

System.Messaging

Szerelvény:

System.Messaging.dll

Lehetővé teszi az alkalmazás számára szükséges üzenetsor telepítését és konfigurálását a futtatáshoz. Ezt az osztályt a telepítési segédprogram hívja meg, például InstallUtil.exe, amikor telepít egy 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

Öröklődés

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Megjegyzések

A MessageQueueInstaller telepítési segédprogram az üzenetsorhoz társított beállításjegyzék-értékek írására használja. A telepítési segédprogramokról további információt a Installutil.exe (Telepítőeszköz) című témakörben talál.

Az üzenetsor telepítéséhez hozzon létre egy projekttelepítő osztályt, amely öröklődik a Installerhelyről, és állítsa be az RunInstallerAttribute osztályhoz tartozó értéket true. A projekten belül hozzon létre egy példányt MessageQueueInstaller a telepítés minden üzenetsorához, és adja hozzá a példányt a projekt telepítőosztályához.

Példány létrehozásakor MessageQueueInstaller opcionálisan átadhat egy meglévőt MessageQueue (például egy tesztkiszolgálóról) a MessageQueueInstaller konstruktornak. Ez a módszer automatikusan megadja az új üzenetsor konfigurációs beállításait az átadott üzenetsor beállításainak tükrözésével. Másik lehetőségként manuálisan is beállíthatja a példány tulajdonságait MessageQueueInstaller a kívánt állapotokra, és meghívhatja a paraméter nélküli konstruktort.

A telepítési segédprogram meghívásakor a rendszer a RunInstallerAttribute. Ha igen true, a segédprogram telepíti a projekttelepítőhöz társított gyűjtemény összes üzenetsorát Installers . Ha RunInstallerAttribute igen false, a segédprogram figyelmen kívül hagyja a projekttelepítőt.

A példány egyéb tulajdonságait MessageQueueInstaller a példány projekttelepítő gyűjteményéhez Installers való hozzáadása előtt vagy után is módosíthatja. Például a telepítési segédprogram végrehajtása előtt be kell állítani egy üzenetsort Path .

Általában nem a kódból hívja meg a MessageQueueInstaller metódusokat, általában csak a installutil.exe telepítési segédprogram hívja meg őket. A segédprogram automatikusan meghívja a metódust a Install telepítési folyamat során, és meghívja Commit , ha a telepítés nem okozott kivételt. Szükség esetén biztonsági másolatot készít a hibákról a kivételt létrehozó objektum meghívásával Rollback .

Az alkalmazás telepítési rutinja a projekttelepítő Installer.Context használatával automatikusan fenntartja a már telepített összetevőkkel kapcsolatos információkat. Ezek az állapotinformációk folyamatosan frissülnek, mivel a segédprogram minden példányt MessageQueueInstaller telepített. Általában nem szükséges, hogy a kód explicit módon módosítsa az állapotinformációkat.

Konstruktorok

Name	Description
MessageQueueInstaller()	Inicializálja a MessageQueueInstaller osztály új példányát. Nem állít be példánytulajdonságokat.
MessageQueueInstaller(MessageQueue)	Inicializálja az MessageQueueInstaller osztály új példányát, és inicializálja a telepítési beállításokat egy meglévő MessageQueue példányhoz.

Tulajdonságok

Name	Description
Authenticate	Lekéri vagy beállít egy értéket, amely jelzi, hogy a telepíteni kívánt üzenetsor csak hitelesített üzeneteket fogad-e el.
BasePriority	Lekéri vagy beállítja a nyilvános üzenetsor üzeneteinek hálózaton keresztüli átirányításához használt alap prioritást.
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
Category	Beolvas vagy beállít egy implementációspecifikus üzenetsortípust.
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
Context	Lekéri vagy beállítja az aktuális telepítéssel kapcsolatos információkat. (Öröklődés forrása Installer)
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
EncryptionRequired	Lekéri vagy beállít egy értéket, amely jelzi, hogy az üzenetsor csak privát vagy titkosított üzeneteket fogad-e el.
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
HelpText	Lekéri a telepítőgyűjtemény összes telepítőjének súgószövegét. (Öröklődés forrása Installer)
Installers	Lekéri a telepítő által tartalmazott telepítők gyűjteményét. (Öröklődés forrása Installer)
Label	Lekéri vagy beállítja az üzenetsor leírását.
MaximumJournalSize	Lekéri vagy beállítja az üzenetsorhoz társított napló maximális méretét.
MaximumQueueSize	Lekéri vagy beállítja az üzenetsor maximális méretét.
MulticastAddress	Az MSMQ 3.0-ban bevezetett. Lekéri vagy beállítja az üzenetsorhoz társított csoportos küldési címet.
Parent	Lekéri vagy beállítja azt a gyűjteményt tartalmazó telepítőt, amelyhez ez a telepítő tartozik. (Öröklődés forrása Installer)
Path	Lekéri vagy beállítja az objektum által hivatkozott üzenetsor helyét.
Permissions	Lekéri vagy beállítja az üzenetsorhoz társított engedélyeket.
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)
Transactional	Lekéri vagy beállít egy értéket, amely jelzi, hogy az üzenetsor csak a tranzakció részeként küldött üzeneteket fogadja-e el.
UninstallAction	Lekéri vagy beállít egy értéket, amely jelzi, hogy a telepítő mit végez az üzenetsorsal az eltávolításkor: távolítsa el, állítsa vissza a telepítés előtti állapotába, vagy hagyja a jelenlegi telepített állapotában.
UseJournalQueue	Lekéri vagy beállít egy értéket, amely jelzi, hogy az üzenetsorból lekért üzenetek is át lesznek-e másolva a társított naplósorba.

Metódusok

Name	Description
Commit(IDictionary)	Befejezi a telepítési folyamatot a metódus által a MessageQueue beállításjegyzékbe írt telepítési információk Install(IDictionary) véglegesítésével. Ezt a módszert a telepítési eszközöknek kell használniuk, amelyek automatikusan meghívják a megfelelő módszereket.
CopyFromComponent(IComponent)	Átmásolja egy MessageQueue összetevő tulajdonságértékeit, amelyek az üzenetsor telepítési idején szükségesek.
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
Dispose()	Felszabadítja a .-hez használt összes erőforrást Component. (Öröklődés forrása Component)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által Component használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat. (Öröklődés forrása Component)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által ComponentContainernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
Install(IDictionary)	Elvégzi a telepítést, és üzenetsoradatokat ír a beállításjegyzékbe. Ezt a módszert a telepítési eszközöknek kell használniuk, amelyek automatikusan meghívják a megfelelő módszereket.
IsEquivalentInstaller(ComponentInstaller)	Meghatározza, hogy a megadott telepítő képes-e kezelni ugyanazt a telepítést, mint ez a telepítő.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
OnAfterInstall(IDictionary)	Az eseményt emeli AfterInstall ki. (Öröklődés forrása Installer)
OnAfterRollback(IDictionary)	Az eseményt emeli AfterRollback ki. (Öröklődés forrása Installer)
OnAfterUninstall(IDictionary)	Az eseményt emeli AfterUninstall ki. (Öröklődés forrása Installer)
OnBeforeInstall(IDictionary)	Az eseményt emeli BeforeInstall ki. (Öröklődés forrása Installer)
OnBeforeRollback(IDictionary)	Az eseményt emeli BeforeRollback ki. (Öröklődés forrása Installer)
OnBeforeUninstall(IDictionary)	Az eseményt emeli BeforeUninstall ki. (Öröklődés forrása Installer)
OnCommitted(IDictionary)	Az eseményt emeli Committed ki. (Öröklődés forrása Installer)
OnCommitting(IDictionary)	Az eseményt emeli Committing ki. (Öröklődés forrása Installer)
Rollback(IDictionary)	Visszaállítja a számítógépet arra az állapotra, amelyben a telepítés előtt volt, a telepítési eljárás által a beállításjegyzékbe írt üzenetsoradatok visszaállításával. Ezt a módszert a telepítési eszközöknek kell használniuk, amelyek automatikusan meghívják a megfelelő módszereket.
ToString()	String A ( ha van) nevet tartalmazó értéket Componentad vissza. Ezt a módszert nem szabad felülírni. (Öröklődés forrása Component)
Uninstall(IDictionary)	Eltávolít egy telepítést úgy, hogy eltávolítja az üzenetsor adatait a beállításjegyzékből. Ezt a módszert az eltávolítási eszközöknek kell használniuk, amelyek automatikusan meghívják a megfelelő módszereket.

esemény

Name	Description
AfterInstall	A tulajdonságban lévő Install(IDictionary) összes telepítő metódusának futtatása után Installers következik be. (Öröklődés forrása Installer)
AfterRollback	A tulajdonságban lévő Installers összes telepítő telepítése után következik be. (Öröklődés forrása Installer)
AfterUninstall	Akkor következik be, ha a tulajdonság összes telepítője végrehajtja az Installers eltávolítási műveleteket. (Öröklődés forrása Installer)
BeforeInstall	A telepítőgyűjteményben lévő összes telepítő metódusának futtatása előtt Install(IDictionary) következik be. (Öröklődés forrása Installer)
BeforeRollback	A tulajdonság telepítőinek Installers visszaállítása előtt történik. (Öröklődés forrása Installer)
BeforeUninstall	Mielőtt a tulajdonság telepítői végrehajtanák az Installers eltávolítási műveleteket. (Öröklődés forrása Installer)
Committed	Akkor fordul elő, ha a tulajdonság összes telepítője véglegesítette a Installers telepítést. (Öröklődés forrása Installer)
Committing	Mielőtt a tulajdonság telepítői véglegesítik a Installers telepítésüket. (Öröklődés forrása Installer)
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)

Lásd még

• Installutil.exe (telepítőeszköz)