MessageQueueInstaller.Install(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.
Wykonuje instalację i zapisuje informacje o kolejce komunikatów w rejestrze. Ta metoda ma być używana przez narzędzia instalacyjne, które automatycznie nazywają odpowiednie metody.
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)Parametry
- stateSaver
- IDictionary
Element IDictionary służący do zapisywania informacji potrzebnych do wykonania operacji zatwierdzania, wycofywania lub odinstalowywania.
Uwagi
Metoda Install zapisuje informacje o kolejce komunikatów do rejestru i kojarzy MessageQueue wystąpienie z kolejką znajdującą się w ścieżce określonej przez Path właściwość . Jeśli kolejka jeszcze nie istnieje, Install tworzy kolejkę transakcyjną. Install Ustawia nowe lub istniejące właściwości kolejki na te, które zostały określone w obiekcie MessageQueueInstaller. Jeśli kolejka już istnieje, jej właściwości są resetowane do właściwości MessageQueueInstaller. Jeśli istniejąca kolejka nie jest transakcyjna, zostanie usunięta, a następnie ponownie utworzona jako kolejka transakcyjna.
Przestroga
Jeśli konieczne jest ponowne utworzenie kolejki, komunikaty w kolejce zostaną utracone.
Zazwyczaj metody metody z wewnątrz kodu nie są wywoływane MessageQueueInstaller . Są one zwykle wywoływane tylko przez narzędzie instalacyjne installutil.exe. Narzędzie automatycznie wywołuje metodę Install podczas procesu instalacji, aby zapisywać informacje rejestru skojarzone z instalowaną kolejką komunikatów. Instalacja jest transakcyjna, więc jeśli podczas instalacji wystąpi awaria jakiegokolwiek 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 instalacji narzędzie instalacyjne zatwierdza instalacje. Commit kończy instalację MessageQueue obiektu przez ustawienie kolejki 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 InstallstateSaver parametr, są stale aktualizowane, gdy narzędzie instaluje każde MessageQueueInstaller wystąpienie. Zwykle kod nie musi jawnie modyfikować tych informacji o stanie.
