Udostępnij za pośrednictwem


MessageQueueInstaller.Commit(IDictionary) Metoda

Definicja

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 -> unit
Public 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ą.

Dotyczy

Zobacz też