EventLogInstaller.Log Eigenschaft
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.
Dient zum Abrufen oder Festlegen des Namens des Protokolls, auf das die Quelle festgelegt werden soll.
public:
property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, setPublic Property Log As StringEigenschaftswert
Der Name des Protokolls. Dies kann ein Anwendungs-, System- oder ein benutzerdefinierter Protokollname sein. Der Standardwert ist eine leere Zeichenfolge ("").
- Attribute
Hinweise
Mit der Log Eigenschaft können Sie die in der Source Eigenschaft angegebene Quelle entweder einem vorhandenen Protokoll oder einem neuen Protokoll auf dem lokalen Computer zuordnen. Das Installutil.exe (Installer Tool) verwendet diese Informationen, um die Quelle dem Protokoll in der Registrierung des Computers zuzuordnen. Anwendungen und Dienste sollten in das Anwendungsprotokoll oder ein benutzerdefiniertes Protokoll schreiben. Gerätetreiber sollten in das Systemprotokoll schreiben.
Um Einträge in ein Ereignisprotokoll zu schreiben, müssen Sie eine Quelle erstellen und mit einem Ereignisprotokoll registrieren. Eine Ereignisquelle kann nur jeweils in ein Protokoll schreiben. Das Installationsprogramm verwendet den Wert der Source Eigenschaft, um Ihre Anwendung mit dem Ereignisprotokoll als gültige Quelle von Einträgen zu registrieren. Wenn Sie vor der Ausführung des Installers keinen Protokollnamen angeben, registriert das Installationsprogramm Ihre Quelle im Anwendungsprotokoll. Wenn Sie eine neue Quelle und ein vorhandenes Protokoll angeben, erstellt das Installationsprogramm eine neue Ereignisquelle und ordnet sie dem angegebenen Protokoll zu. Wenn Sie sowohl eine neue Quelle als auch ein neues Protokoll angeben, ordnet das Installationsprogramm die neue Quelle dem neuen Protokoll in der Registrierung zu, aber das Protokoll wird erst erstellt, wenn der erste Eintrag darin geschrieben wird.
Das Betriebssystem speichert Ereignisprotokolle als Dateien. Wenn Sie ein neues Ereignisprotokoll mithilfe EventLogInstaller oder der CreateEventSource Methode erstellen, wird die zugeordnete Datei im Verzeichnis %SystemRoot%\System32\Config auf dem angegebenen Computer gespeichert. Der Dateiname wird festgelegt, indem die ersten 8 Zeichen der Log Eigenschaft mit der Dateinamenerweiterung ".evt" angefügt werden.
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 registriert die Quelle nicht, wenn die Source Eigenschaft mit einem Quellnamen übereinstimmt, der bereits für dasselbe Ereignisprotokoll registriert ist, das in der Log Eigenschaft angegeben ist.
Ausführlichere Informationen über das Verhalten von Ereignisprotokollen und -quellen finden Sie in der EventLog Klassendokumentation für die und Source die Log Eigenschaften.
