Udostępnij za pośrednictwem

MessageQueueInstaller.Install(IDictionary) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

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

Dotyczy

Zobacz też