Udostępnij przez

EventLogInstaller.Install(IDictionary) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Diagnostics
Zestaw:
System.Configuration.Install.dll

Wykonuje instalację i zapisuje informacje dziennika zdarzeń w rejestrze.

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

Służy IDictionary do zapisywania informacji potrzebnych do wykonania operacji wycofywania lub odinstalowywania.

Wyjątki

ArgumentException

Nazwa określona we Source właściwości jest już zarejestrowana dla innego dziennika zdarzeń.

Uwagi

Metoda Install zapisuje informacje dziennika zdarzeń w rejestrze i kojarzy dziennik zdarzeń z dziennikiem określonym przez Log właściwość. Jeśli dziennik jeszcze nie istnieje (a źródło jest określone), Install tworzy dziennik i kojarzy z nim nowe źródło.

Zazwyczaj nie wywołuje się metod metody EventLogInstaller z poziomu kodu; są one zwykle wywoływane tylko przez Installutil.exe (narzędzie instalatora). Narzędzie automatycznie wywołuje metodę Install podczas procesu instalacji, aby zapisywać informacje o rejestrze skojarzone z zainstalowanym dziennikiem zdarzeń. 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 .

Użyj EventLogInstaller polecenia , aby zarejestrować nowe źródło dla nowego lub istniejącego dziennika zdarzeń; nie używaj polecenia EventLogInstaller , aby zmienić istniejące źródło. Klasa EventLogInstaller nie modyfikuje właściwości konfiguracji istniejącego źródła w celu dopasowania do określonych właściwości instalacji. Metoda Install zgłasza wyjątek, jeśli Source właściwość jest zgodna z nazwą źródłową zarejestrowaną dla innego dziennika zdarzeń na komputerze. Metoda Install pomija rejestrowanie źródła, jeśli Source właściwość jest zgodna z nazwą źródłową, która jest już zarejestrowana dla tego samego dziennika zdarzeń określonego Log we właściwości.

Procedura instalacji aplikacji używa właściwości 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 w miarę instalowania każdego EventLogInstallernarzędzia . Zazwyczaj nie jest konieczne, aby kod jawnie zmodyfikował te informacje o stanie.

Dotyczy

Zobacz też