EventLogInstaller.Install-Methode

Führt die Installation durch und schreibt Ereignisprotokollinformationen in die Registrierung.

Namespace: System.Diagnostics
Assembly: System.Configuration.Install (in system.configuration.install.dll)

Syntax

'Declaration
Public Overrides Sub Install ( _
    stateSaver As IDictionary _
)
'Usage
Dim instance As EventLogInstaller
Dim stateSaver As IDictionary

instance.Install(stateSaver)

public override void Install (
    IDictionary stateSaver
)

public:
virtual void Install (
    IDictionary^ stateSaver
) override

public void Install (
    IDictionary stateSaver
)

public override function Install (
    stateSaver : IDictionary
)

Parameter

• stateSaver
  Ein IDictionary, in dem die zum Ausführen eines Rollback- oder Deinstallationsvorgangs erforderlichen Daten gespeichert werden.

Ausnahmen

Hinweise

Die Install-Methode schreibt Ereignisprotokollinformationen in die Registrierung und ordnet das Ereignisprotokoll einem durch die Log-Eigenschaft angegebenen Protokoll zu. Wenn das Protokoll noch nicht vorhanden ist (und eine Quelle angegeben wurde), erstellt Install ein Protokoll und ordnet diesem die neue Quelle zu.

Normalerweise werden die Methoden des EventLogInstaller nicht über den Code, sondern nur vom Installer-Tool (Installutil.exe) aufgerufen. Das Tool ruft während des Installationsprozesses automatisch die Install-Methode auf, um Registrierungsinformationen zu schreiben, die dem zu installierenden Ereignisprotokoll zugeordnet sind. Die Installation ist transaktional, d. h. bei einem Fehler bei der Installation einer beliebigen Komponente des Installationsprojekts werden alle bereits installierten Komponenten in ihren Zustand vor der Installation zurückversetzt. Dies geschieht durch den Aufruf der Rollback-Methode für die jeweilige Komponente.

Verwenden Sie EventLogInstaller zum Registrieren einer neuen Quelle für ein neues oder vorhandenes Ereignisprotokoll. EventLogInstaller darf nicht zum Ändern einer vorhandenen Quelle verwendet werden. Mit der EventLogInstaller-Klasse werden die Konfigurationseigenschaften einer vorhandenen Quelle nicht an die angegebenen Installationseigenschaften angepasst. Die Install-Methode löst eine Ausnahme aus, wenn die Source-Eigenschaft mit einem Quellnamen übereinstimmt, der für ein anderes Ereignisprotokoll auf dem Computer registriert ist. Die Quellregistrierung wird von der Install-Methode übersprungen, wenn die Source-Eigenschaft mit einem Quellnamen identisch ist, der bereits für das gleiche, in der Log-Eigenschaft angegebene Ereignisprotokoll registriert ist.

Die Installationsroutine einer Anwendung verwendet die Installer.Context-Eigenschaft des Projektinstallationsprogramms für die automatische Verwaltung von Informationen zu bereits installierten Komponenten. Diese Zustandsinformationen, die als stateSaver-Parameter an die Install-Methode übergeben werden, werden während der Installation der einzelnen EventLogInstaller mithilfe des Tools fortlaufend aktualisiert. Normalerweise müssen diese Zustandsinformationen vom Code nicht explizit geändert werden.

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

EventLogInstaller-Klasse
EventLogInstaller-Member
System.Diagnostics-Namespace
Rollback
Uninstall
IDictionary