EventLogInstaller.Install(IDictionary) Methode

  • Referenz

Definition

Namespace:
System.Diagnostics
Assembly:
System.Configuration.Install.dll

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

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)

Parameter

stateSaver
IDictionary

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

Ausnahmen

ArgumentException

Der in der Source-Eigenschaft angegebene Name wurde bereits für ein anderes Ereignisprotokoll registriert.

Hinweise

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

In der Regel rufen Sie die Methoden von EventLogInstaller in Ihrem Code nicht auf. Sie werden in der Regel nur vom Installutil.exe (Installer Tool) aufgerufen. Das Tool ruft die Install -Methode während des Installationsvorgangs automatisch auf, um Registrierungsinformationen zu schreiben, die dem installierten Ereignisprotokoll zugeordnet sind. Die Installation ist transaktional. Wenn also während der Installation ein Fehler einer Installationsprojektkomponente auftritt, wird für alle zuvor installierten Komponenten ein Rollback auf den Zustand der Vorinstallation ausgeführt. Dies wird erreicht, indem die -Methode jeder Komponente Rollback aufgerufen wird.

Verwenden Sie , um eine neue Quelle für ein neues oder vorhandenes Ereignisprotokoll zu registrieren. Verwenden Sie EventLogInstaller nicht , EventLogInstaller um eine vorhandene Quelle zu ändern. Die EventLogInstaller -Klasse ändert die Konfigurationseigenschaften einer vorhandenen Quelle nicht so, dass sie den angegebenen Installationseigenschaften entsprechen. 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 Install -Methode überspringt die Registrierung der Quelle, wenn die Source Eigenschaft mit einem Quellnamen übereinstimmt, der bereits für das in der Log -Eigenschaft angegebene Ereignisprotokoll registriert ist.

Die Installationsroutine einer Anwendung verwendet die -Eigenschaft des Projektinstallationsprogramms Installer.Context , um automatisch Informationen zu den bereits installierten Komponenten zu verwalten. Diese Zustandsinformationen, die als stateSaver Parameter an übergeben Install werden, werden kontinuierlich aktualisiert, wenn das Tool jede EventLogInstallerinstalliert. In der Regel ist es nicht erforderlich, dass Ihr Code diese Zustandsinformationen explizit ändert.

Gilt für:

Weitere Informationen