MessageQueueInstaller.Commit(IDictionary) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Kończy proces instalacji, zatwierdzając MessageQueue informacje o instalacji, które Install(IDictionary) metoda napisała do rejestru. Ta metoda ma być używana przez narzędzia instalacyjne, które automatycznie nazywają odpowiednie metody.
public:
override void Commit(System::Collections::IDictionary ^ savedState);public override void Commit (System.Collections.IDictionary savedState);override this.Commit : System.Collections.IDictionary -> unitPublic Overrides Sub Commit (savedState As IDictionary)Parametry
- savedState
- IDictionary
Element IDictionary zawierający stan po instalacji komputera.
Uwagi
Zazwyczaj nie wywołuje się metod metody MessageQueueInstaller z poziomu kodu; są one zwykle wywoływane tylko przez narzędzie instalacyjne installutil.exe. Narzędzie automatycznie wywołuje metodę Install podczas procesu instalacji. Instalacja jest transakcyjna, więc jeśli podczas instalacji wystąpi awaria dowolnego składnika projektu instalacji, wszystkie wcześniej zainstalowane składniki zostaną wycofane ze stanów przed instalacją. Jest to realizowane przez wywołanie metody każdego składnika Rollback .
Po pomyślnej instalacji wszystkich składników skojarzonych z projektem instalacyjnym narzędzie instalacyjne zatwierdza instalacje. Commit kończy instalację obiektu MessageQueue , ustawiając kolejkę na odpowiedni stan początkowy. Jeśli kolejka określona Path przez właściwość już istnieje i zawiera komunikaty, Commit czyści komunikaty. Commit, a nie Install, czyści komunikaty, ponieważ nie można wycofać działania przeczyszczania komunikatów.
Procedura instalacji aplikacji używa instalatora Installer.Context projektu do automatycznego utrzymywania informacji o składnikach, które zostały już zainstalowane. Te informacje o stanie, które są przekazywane jako CommitsavedState parametr, są stale aktualizowane, ponieważ narzędzie zatwierdza każde MessageQueueInstaller wystąpienie. Zazwyczaj nie jest konieczne, aby kod jawnie zmodyfikował te informacje o stanie. Po wyczyszczonej Commit kolejce opublikuje wpis dziennika skojarzony savedState z instalacją.
