MessageQueueInstaller.Install(IDictionary) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.
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)Parametrar
- stateSaver
- IDictionary
En IDictionary som används för att spara information som behövs för att utföra en inchecknings-, återställnings- eller avinstallationsåtgärd.
Kommentarer
Metoden Install skriver meddelandeköinformation till registret och associerar instansen MessageQueue med en kö som finns på den sökväg som anges av Path egenskapen. Om kön inte redan finns Install skapar du en transaktionskö. Install anger de nya eller befintliga köegenskaperna till de som du har angett i MessageQueueInstaller. Om kön redan finns återställs dess egenskaper till egenskaperna för MessageQueueInstaller. Om den befintliga kön inte är transaktionell tas den bort och återskapas sedan som en transaktionskö.
Caution
Om du behöver återskapa kön går meddelandena i kön förlorade.
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 för att skriva registerinformation som är associerad med att meddelandekön installeras. Installationen är transaktionell, så om det uppstår ett fel på någon installationsprojektkomponent under installationen återställs alla tidigare installerade komponenter till sina förinstallationstillstånd. Detta uppnås genom att anropa varje komponents Rollback -metod.
När installationen av alla komponenter som är associerade med installationsprojektet har slutförts genomför installationsverktyget installationerna. Commit slutför installationen av genom MessageQueue att ställa in kön på lämpligt initialt tillstånd. Om kön som anges av Path egenskapen redan finns och innehåller meddelanden rensar Commit du meddelandena. Commiti stället Installför rensar meddelandena eftersom det inte går att återställa rensningen av meddelandena.
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åndsinformationenInstall, som skickas till stateSaver som parameter, uppdateras kontinuerligt när verktyget installerar varje MessageQueueInstaller instans. Vanligtvis är det inte nödvändigt att koden uttryckligen ändrar den här tillståndsinformationen.
