MessageQueueInstaller Klas

Definitie

Hiermee kunt u een wachtrij installeren en configureren die uw toepassing nodig heeft om te kunnen worden uitgevoerd. Deze klasse wordt aangeroepen door het installatiehulpprogramma, bijvoorbeeld InstallUtil.exe, bij het installeren van een 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
Overname

Opmerkingen

Het MessageQueueInstaller wordt gebruikt door het installatieprogramma om registerwaarden te schrijven die aan de wachtrij zijn gekoppeld. Zie Installutil.exe (Installer Tool) voor meer informatie over installatieprogramma's.

Als u een wachtrij wilt installeren, maakt u een klasse voor het installatieprogramma van het project die wordt overgenomen van de Installerklasse en stelt u de RunInstallerAttribute klasse in op true. Maak in uw project een MessageQueueInstaller exemplaar voor elke wachtrij in de installatie en voeg het exemplaar toe aan uw projectinstallatieklasse.

Wanneer u een MessageQueueInstaller exemplaar maakt, kunt u eventueel een bestaande MessageQueue (bijvoorbeeld van een testserver) doorgeven aan de MessageQueueInstaller constructor. Deze methode biedt automatisch de configuratie-instellingen voor de nieuwe wachtrij door de instellingen van de doorgegeven wachtrij te spiegelen. U kunt de eigenschappen in het MessageQueueInstaller exemplaar ook handmatig instellen op de gewenste statussen en de parameterloze constructor aanroepen.

Wanneer het installatieprogramma wordt aangeroepen, zoekt het naar de RunInstallerAttribute. Als dat het is true, installeert het hulpprogramma alle wachtrijen in de Installers verzameling die is gekoppeld aan uw projectinstallatieprogramma. Als RunInstallerAttribute dat het is false, negeert het hulpprogramma het installatieprogramma van het project.

U wijzigt andere eigenschappen van een MessageQueueInstaller exemplaar vóór of na het toevoegen van het exemplaar aan de Installers verzameling van het projectinstallatieprogramma. Een wachtrij Path moet bijvoorbeeld worden ingesteld voordat het installatieprogramma wordt uitgevoerd.

Normaal gesproken roept u de methoden van de methoden van de MessageQueueInstaller code niet aan; ze worden meestal alleen aangeroepen door het installutil.exe installatiehulpprogramma. Het hulpprogramma roept automatisch de Install methode aan tijdens het installatieproces en roept aan Commit als de installatie geen uitzondering heeft gegenereerd. Er worden zo nodig fouten geretourneerd door het object aan te roepen Rollback dat de uitzondering heeft gegenereerd.

De installatieroutine van een toepassing maakt gebruik van de installatieroutine van Installer.Context het project om automatisch informatie te onderhouden over de onderdelen die al zijn geïnstalleerd. Deze statusinformatie wordt continu bijgewerkt wanneer elk MessageQueueInstaller exemplaar wordt geïnstalleerd door het hulpprogramma. Het is meestal niet nodig voor uw code om de statusgegevens expliciet te wijzigen.

Constructors

Name Description
MessageQueueInstaller()

Initialiseert een nieuw exemplaar van de MessageQueueInstaller klasse. Er worden geen exemplaareigenschappen ingesteld.

MessageQueueInstaller(MessageQueue)

Initialiseert een nieuw exemplaar van de MessageQueueInstaller klasse, waarbij de installatie-instellingen worden geïnitialiseerd naar die van een bestaand MessageQueue exemplaar.

Eigenschappen

Name Description
Authenticate

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de wachtrij die moet worden geïnstalleerd alleen geverifieerde berichten accepteert.

BasePriority

Hiermee wordt de basisprioriteit opgehaald of ingesteld die wordt gebruikt om berichten van een openbare wachtrij via het netwerk te routeren.

CanRaiseEvents

Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel een gebeurtenis kan genereren.

(Overgenomen van Component)
Category

Hiermee wordt een implementatiespecifiek wachtrijtype opgehaald of ingesteld.

Container

Hiermee haalt u het IContainer bestand op dat de Component.

(Overgenomen van Component)
Context

Hiermee haalt u informatie over de huidige installatie op of stelt u deze in.

(Overgenomen van Installer)
DesignMode

Hiermee wordt een waarde opgehaald die aangeeft of de Component momenteel in de ontwerpmodus is.

(Overgenomen van Component)
EncryptionRequired

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de wachtrij alleen privé- of versleutelde berichten accepteert.

Events

Hiermee haalt u de lijst met gebeurtenis-handlers op die aan dit Componentbestand zijn gekoppeld.

(Overgenomen van Component)
HelpText

Hiermee haalt u de Help-tekst op voor alle installatieprogramma's in de installatieverzameling.

(Overgenomen van Installer)
Installers

Hiermee haalt u de verzameling installatieprogramma's op die dit installatieprogramma bevat.

(Overgenomen van Installer)
Label

Hiermee wordt een beschrijving van de wachtrij opgehaald of ingesteld.

MaximumJournalSize

Hiermee wordt de maximale grootte van het logboek opgehaald of ingesteld dat is gekoppeld aan de wachtrij.

MaximumQueueSize

Hiermee wordt de maximale grootte van de wachtrij opgehaald of ingesteld.

MulticastAddress

Geïntroduceerd in MSMQ 3.0. Hiermee wordt het multicast-adres opgehaald of ingesteld dat aan de wachtrij is gekoppeld.

Parent

Hiermee haalt u het installatieprogramma op met de verzameling waartoe dit installatieprogramma behoort.

(Overgenomen van Installer)
Path

Hiermee wordt de locatie opgehaald of ingesteld van de wachtrij waarnaar wordt verwezen door dit object.

Permissions

Hiermee worden machtigingen opgehaald of ingesteld die zijn gekoppeld aan de wachtrij.

Site

Haalt of stelt de ISite van de Component.

(Overgenomen van Component)
Transactional

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de wachtrij alleen berichten accepteert die als onderdeel van een transactie worden verzonden.

UninstallAction

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft wat het installatieprogramma doet met de wachtrij tijdens het verwijderen: verwijder deze, herstel deze naar de status vóór de installatie of laat deze in de huidige geïnstalleerde status staan.

UseJournalQueue

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of berichten die uit de wachtrij worden opgehaald, ook worden gekopieerd naar de bijbehorende logboekwachtrij.

Methoden

Name Description
Commit(IDictionary)

Voltooit het installatieproces door de MessageQueue installatiegegevens door te voeren die door de Install(IDictionary) methode naar het register zijn geschreven. Deze methode is bedoeld om te worden gebruikt door installatiehulpprogramma's, die automatisch de juiste methoden aanroepen.

CopyFromComponent(IComponent)

Kopieert de eigenschapswaarden van een MessageQueue onderdeel dat tijdens de installatie is vereist voor een berichtenwachtrij.

CreateObjRef(Type)

Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object.

(Overgenomen van MarshalByRefObject)
Dispose()

Alle resources die worden gebruikt door de Component.

(Overgenomen van Component)
Dispose(Boolean)

Publiceert de niet-beheerde resources die worden gebruikt door de Component beheerde resources en brengt eventueel de beheerde resources vrij.

(Overgenomen van Component)
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetLifetimeService()
Verouderd.

Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd.

(Overgenomen van MarshalByRefObject)
GetService(Type)

Hiermee wordt een object geretourneerd dat een service vertegenwoordigt die wordt geleverd door of door de Component service Container.

(Overgenomen van Component)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
InitializeLifetimeService()
Verouderd.

Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren.

(Overgenomen van MarshalByRefObject)
Install(IDictionary)

Voert de installatie uit en schrijft informatie over de berichtenwachtrij naar het register. Deze methode is bedoeld om te worden gebruikt door installatiehulpprogramma's, die automatisch de juiste methoden aanroepen.

IsEquivalentInstaller(ComponentInstaller)

Bepaalt of het opgegeven installatieprogramma hetzelfde type installatie kan verwerken als dit installatieprogramma.

MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
MemberwiseClone(Boolean)

Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object.

(Overgenomen van MarshalByRefObject)
OnAfterInstall(IDictionary)

Hiermee wordt de AfterInstall gebeurtenis gegenereerd.

(Overgenomen van Installer)
OnAfterRollback(IDictionary)

Hiermee wordt de AfterRollback gebeurtenis gegenereerd.

(Overgenomen van Installer)
OnAfterUninstall(IDictionary)

Hiermee wordt de AfterUninstall gebeurtenis gegenereerd.

(Overgenomen van Installer)
OnBeforeInstall(IDictionary)

Hiermee wordt de BeforeInstall gebeurtenis gegenereerd.

(Overgenomen van Installer)
OnBeforeRollback(IDictionary)

Hiermee wordt de BeforeRollback gebeurtenis gegenereerd.

(Overgenomen van Installer)
OnBeforeUninstall(IDictionary)

Hiermee wordt de BeforeUninstall gebeurtenis gegenereerd.

(Overgenomen van Installer)
OnCommitted(IDictionary)

Hiermee wordt de Committed gebeurtenis gegenereerd.

(Overgenomen van Installer)
OnCommitting(IDictionary)

Hiermee wordt de Committing gebeurtenis gegenereerd.

(Overgenomen van Installer)
Rollback(IDictionary)

Herstelt de computer naar de status waarin deze zich vóór de installatie bevond, door de wachtrijgegevens terug te draaien die door de installatieprocedure naar het register zijn geschreven. Deze methode is bedoeld om te worden gebruikt door installatiehulpprogramma's, die automatisch de juiste methoden aanroepen.

ToString()

Retourneert een String met de naam van de Component, indien van toepassing. Deze methode mag niet worden overschreven.

(Overgenomen van Component)
Uninstall(IDictionary)

Hiermee verwijdert u een installatie door wachtrijgegevens uit het register te verwijderen. Deze methode is bedoeld om te worden gebruikt door hulpprogramma's voor verwijderen, die automatisch de juiste methoden aanroepen.

gebeurtenis

Name Description
AfterInstall

Vindt plaats nadat de Install(IDictionary) methoden van alle installatieprogramma's in de Installers eigenschap zijn uitgevoerd.

(Overgenomen van Installer)
AfterRollback

Vindt plaats nadat de installaties van alle installatieprogramma's in de Installers eigenschap zijn teruggedraaid.

(Overgenomen van Installer)
AfterUninstall

Vindt plaats nadat alle installatieprogramma's in de Installers eigenschap hun verwijderingsbewerkingen uitvoeren.

(Overgenomen van Installer)
BeforeInstall

Vindt plaats voordat de Install(IDictionary) methode van elk installatieprogramma in de installatieverzameling is uitgevoerd.

(Overgenomen van Installer)
BeforeRollback

Vindt plaats voordat de installatieprogramma's in de Installers eigenschap worden teruggedraaid.

(Overgenomen van Installer)
BeforeUninstall

Vindt plaats voordat de installatieprogramma's in de Installers eigenschap hun verwijderingsbewerkingen uitvoeren.

(Overgenomen van Installer)
Committed

Vindt plaats nadat alle installatieprogramma's in de Installers eigenschap hun installaties hebben doorgevoerd.

(Overgenomen van Installer)
Committing

Vindt plaats voordat de installatieprogramma's in de Installers eigenschap hun installaties doorvoeren.

(Overgenomen van Installer)
Disposed

Treedt op wanneer het onderdeel wordt verwijderd door een aanroep naar de Dispose() methode.

(Overgenomen van Component)

Van toepassing op

Zie ook