EventLogInstaller.Install(IDictionary) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Führt die Installations- und Schreibzugriffsprotokollinformationen in die Registrierung durch.
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)Parameter
- stateSaver
- IDictionary
Dient IDictionary zum Speichern von Informationen, die zum Ausführen eines Rollback- oder Deinstallationsvorgangs erforderlich sind.
Ausnahmen
Der in der Source Eigenschaft angegebene Name ist 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 wird ein Protokoll erstellt und der neuen Quelle zugeordnet.
In der EventLogInstaller Regel rufen Sie die Methoden des Codes 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, werden alle zuvor installierten Komponenten auf ihre Vorinstallationszustände zurückgesetzt. Dazu wird die Methode der einzelnen Komponenten Rollback aufgerufen.
Dient EventLogInstaller zum Registrieren einer neuen Quelle für ein neues oder vorhandenes Ereignisprotokoll; verwenden EventLogInstaller Sie nicht, um eine vorhandene Quelle zu ändern. Die EventLogInstaller Klasse ändert die Konfigurationseigenschaften einer vorhandenen Quelle nicht so, dass sie den angegebenen Installationseigenschaften entspricht. Die Install Methode löst eine Ausnahme aus, wenn die Eigenschaft mit einem Quellnamen übereinstimmt, der Source 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 dasselbe Ereignisprotokoll registriert ist, das in der Log Eigenschaft angegeben ist.
Die Installationsroutine einer Anwendung verwendet die Eigenschaft des Installer.Context Projektinstallationsprogramms, um automatisch Informationen zu den Komponenten zu verwalten, die bereits installiert wurden. Diese Zustandsinformationen, die als stateSaver Parameter übergeben Install werden, werden kontinuierlich aktualisiert, wenn das Tool jedes EventLogInstallerinstalliert. In der Regel ist es für Ihren Code nicht erforderlich, diese Statusinformationen explizit zu ändern.
