EventLogInstaller.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 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 -> unitPublic 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
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.
