MessageQueueInstaller.Install(IDictionary) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install(System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Parameters
- stateSaver
- IDictionary
Een IDictionary gebruikt om informatie op te slaan die nodig is om een doorvoering, terugdraaibewerking of verwijderingsbewerking uit te voeren.
Opmerkingen
De Install methode schrijft informatie over de berichtenwachtrij naar het register en koppelt het MessageQueue exemplaar aan een wachtrij die zich bevindt op het pad dat is opgegeven door de Path eigenschap. Als de wachtrij nog niet bestaat, Install maakt u een transactionele wachtrij. Install stelt de nieuwe of bestaande wachtrijeigenschappen in op de eigenschappen die u in de MessageQueueInstallerwachtrij hebt opgegeven. Als de wachtrij al bestaat, worden de eigenschappen opnieuw ingesteld op die van de MessageQueueInstallerwachtrij. Als de bestaande wachtrij niet transactioneel is, wordt deze verwijderd en vervolgens opnieuw gemaakt als een transactionele wachtrij.
Caution
Als het nodig is om de wachtrij opnieuw te maken, gaan berichten in de wachtrij verloren.
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 om registergegevens te schrijven die zijn gekoppeld aan de berichtenwachtrij die wordt geïnstalleerd. De installatie is transactioneel, dus als er tijdens de installatie een fout optreedt in een installatieprojectonderdeel, worden alle eerder geïnstalleerde onderdelen teruggedraaid naar de status van de installatie. Dit wordt bereikt door de methode van Rollback elk onderdeel aan te roepen.
Na een geslaagde installatie van alle onderdelen die aan het installatieproject zijn gekoppeld, voert het installatieprogramma de installaties door. Commit voltooit de installatie van de MessageQueue wachtrij door de wachtrij in te stellen op de juiste beginstatus. Als de wachtrij die is opgegeven door de Path eigenschap al bestaat en berichten bevat, Commit worden de berichten gewist. Commitin plaats van Installde berichten te wissen omdat het opschonen van de berichten niet kan worden teruggedraaid.
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, die als parameter Install wordt doorgegevenstateSaver, wordt continu bijgewerkt wanneer het hulpprogramma elk MessageQueueInstaller exemplaar installeert. Normaal gesproken is het niet nodig dat uw code deze statusgegevens expliciet wijzigt.
