MessageQueueInstaller Klass

Definition

Gör att du kan installera och konfigurera en kö som programmet behöver för att kunna köras. Den här klassen anropas av installationsverktyget, till exempel InstallUtil.exe, när du installerar en 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
Arv

Kommentarer

MessageQueueInstaller Används av installationsverktyget för att skriva registervärden som är associerade med kön. Mer information om installationsverktyg finns iInstallutil.exe (installationsverktyg).

Om du vill installera en kö skapar du en projektinstallationsklass som ärver från Installeroch anger RunInstallerAttribute för klassen till true. I projektet skapar du en MessageQueueInstaller instans för varje kö i installationen och lägger till instansen i projektinstallationsklassen.

När du skapar en MessageQueueInstaller instans kan du skicka en befintlig MessageQueue (till exempel från en testserver) till MessageQueueInstaller konstruktorn. Den här metoden tillhandahåller automatiskt konfigurationsinställningarna för den nya kön genom att spegla inställningarna för kön som skickades in. Du kan också manuellt ange egenskaperna i instansen MessageQueueInstaller till de tillstånd som du vill använda och anropa den parameterlösa konstruktorn.

När installationsverktyget anropas letar RunInstallerAttributedet efter . Om det är trueinstallerar verktyget alla köer i samlingen Installers som är associerad med projektinstallationsprogrammet. Om RunInstallerAttribute är falseignorerar verktyget projektinstallationsprogrammet.

Du ändrar andra egenskaper för en MessageQueueInstaller instans antingen före eller efter att du har lagt till instansen i Installers samlingen av projektinstallationsprogrammet. En kö Path måste till exempel anges innan installationsverktyget körs.

Vanligtvis anropar du inte metoderna MessageQueueInstaller för inifrån koden. De anropas vanligtvis endast av installutil.exe installationsverktyget. Verktyget anropar Install automatiskt metoden under installationsprocessen och anropar Commit om installationen inte utlöste ett undantag. Om det behövs säkerhetskopieras fel genom att anropa Rollback det objekt som genererade undantaget.

Programmets installationsrutin använder projektinstallationsprogrammet för Installer.Context att automatiskt underhålla information om de komponenter som redan har installerats. Den här tillståndsinformationen uppdateras kontinuerligt när varje MessageQueueInstaller instans installeras av verktyget. Det är vanligtvis inte nödvändigt att koden uttryckligen ändrar tillståndsinformationen.

Konstruktorer

Name Description
MessageQueueInstaller()

Initierar en ny instans av MessageQueueInstaller klassen. Anger inga instansegenskaper.

MessageQueueInstaller(MessageQueue)

Initierar en ny instans av MessageQueueInstaller klassen och initierar installationsinställningarna för en befintlig MessageQueue instans.

Egenskaper

Name Description
Authenticate

Hämtar eller anger ett värde som anger om kön som ska installeras endast accepterar autentiserade meddelanden.

BasePriority

Hämtar eller anger den basprioritet som används för att dirigera en offentlig kös meddelanden via nätverket.

CanRaiseEvents

Hämtar ett värde som anger om komponenten kan generera en händelse.

(Ärvd från Component)
Category

Hämtar eller anger en implementeringsspecifik kötyp.

Container

Hämtar som IContainer innehåller Component.

(Ärvd från Component)
Context

Hämtar eller anger information om den aktuella installationen.

(Ärvd från Installer)
DesignMode

Hämtar ett värde som anger om det Component för närvarande är i designläge.

(Ärvd från Component)
EncryptionRequired

Hämtar eller anger ett värde som anger om kön endast accepterar privata eller krypterade meddelanden.

Events

Hämtar listan över händelsehanterare som är kopplade till den här Component.

(Ärvd från Component)
HelpText

Hämtar hjälptexten för alla installationsprogram i installationssamlingen.

(Ärvd från Installer)
Installers

Hämtar den samling installationsprogram som installationsprogrammet innehåller.

(Ärvd från Installer)
Label

Hämtar eller anger en beskrivning av kön.

MaximumJournalSize

Hämtar eller anger den maximala storleken på journalen som är associerad med kön.

MaximumQueueSize

Hämtar eller anger den maximala storleken på kön.

MulticastAddress

Introducerades i MSMQ 3.0. Hämtar eller anger den multicast-adress som är associerad med kön.

Parent

Hämtar eller anger installationsprogrammet som innehåller den samling som installationsprogrammet tillhör.

(Ärvd från Installer)
Path

Hämtar eller anger platsen för kön som refereras av det här objektet.

Permissions

Hämtar eller anger behörigheter som är associerade med kön.

Site

Hämtar eller ställer in ISite i Component.

(Ärvd från Component)
Transactional

Hämtar eller anger ett värde som anger om kön endast accepterar meddelanden som skickas som en del av en transaktion.

UninstallAction

Hämtar eller anger ett värde som anger vad installationsprogrammet gör med kön vid avinstallationstillfället: ta bort den, återställa den till dess förinstallationstillstånd eller lämna den i sitt aktuella installerade tillstånd.

UseJournalQueue

Hämtar eller anger ett värde som anger om meddelanden som hämtas från kön också kopieras till den associerade journalkön.

Metoder

Name Description
Commit(IDictionary)

Slutför installationsprocessen genom att ange installationsinformationen MessageQueueInstall(IDictionary) som metoden skrev till registret. Den här metoden är avsedd att användas av installationsverktyg, som automatiskt anropar lämpliga metoder.

CopyFromComponent(IComponent)

Kopierar egenskapsvärdena för en MessageQueue komponent som krävs vid installationstillfället för en meddelandekö.

CreateObjRef(Type)

Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt.

(Ärvd från MarshalByRefObject)
Dispose()

Släpper alla resurser som används av Component.

(Ärvd från Component)
Dispose(Boolean)

Släpper de ohanterade resurser som används av Component och släpper eventuellt de hanterade resurserna.

(Ärvd från Component)
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetLifetimeService()
Föråldrad.

Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
GetService(Type)

Returnerar ett objekt som representerar en tjänst som tillhandahålls av Component eller av dess Container.

(Ärvd från Component)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
InitializeLifetimeService()
Föråldrad.

Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
Install(IDictionary)

Utför installationen och skriver meddelandeköinformation till registret. Den här metoden är avsedd att användas av installationsverktyg, som automatiskt anropar lämpliga metoder.

IsEquivalentInstaller(ComponentInstaller)

Avgör om den angivna installationsprogrammet kan hantera samma typ av installation som det här installationsprogrammet.

MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
MemberwiseClone(Boolean)

Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet.

(Ärvd från MarshalByRefObject)
OnAfterInstall(IDictionary)

Genererar händelsen AfterInstall .

(Ärvd från Installer)
OnAfterRollback(IDictionary)

Genererar händelsen AfterRollback .

(Ärvd från Installer)
OnAfterUninstall(IDictionary)

Genererar händelsen AfterUninstall .

(Ärvd från Installer)
OnBeforeInstall(IDictionary)

Genererar händelsen BeforeInstall .

(Ärvd från Installer)
OnBeforeRollback(IDictionary)

Genererar händelsen BeforeRollback .

(Ärvd från Installer)
OnBeforeUninstall(IDictionary)

Genererar händelsen BeforeUninstall .

(Ärvd från Installer)
OnCommitted(IDictionary)

Genererar händelsen Committed .

(Ärvd från Installer)
OnCommitting(IDictionary)

Genererar händelsen Committing .

(Ärvd från Installer)
Rollback(IDictionary)

Återställer datorn till det tillstånd den befann sig i före installationen genom att återställa köinformationen som installationsproceduren skrev till registret. Den här metoden är avsedd att användas av installationsverktyg, som automatiskt anropar lämpliga metoder.

ToString()

Returnerar ett String som innehåller namnet på Component, om det finns. Den här metoden bör inte åsidosättas.

(Ärvd från Component)
Uninstall(IDictionary)

Tar bort en installation genom att ta bort köinformation från registret. Den här metoden är avsedd att användas av avinstallationsverktyg, som automatiskt anropar lämpliga metoder.

Händelser

Name Description
AfterInstall

Inträffar när metoderna för Install(IDictionary) alla installationsprogram i egenskapen Installers har körts.

(Ärvd från Installer)
AfterRollback

Inträffar när installationerna av alla installationsprogram i Installers egenskapen har återställts.

(Ärvd från Installer)
AfterUninstall

Inträffar när alla installationsprogram i egenskapen Installers utför sina avinstallationsåtgärder.

(Ärvd från Installer)
BeforeInstall

Inträffar innan metoden för Install(IDictionary) varje installationsprogram i installationssamlingen har körts.

(Ärvd från Installer)
BeforeRollback

Inträffar innan installationsprogrammet i egenskapen Installers återställs.

(Ärvd från Installer)
BeforeUninstall

Inträffar innan installationsprogrammet i egenskapen Installers utför sina avinstallationsåtgärder.

(Ärvd från Installer)
Committed

Inträffar när alla installationsprogram i Installers egenskapen har checkat in sina installationer.

(Ärvd från Installer)
Committing

Inträffar innan installationsprogrammet i egenskapen Installers checkar in sina installationer.

(Ärvd från Installer)
Disposed

Inträffar när komponenten tas bort av ett anrop till Dispose() metoden.

(Ärvd från Component)

Gäller för

Se även