EventLogInstaller.Log Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Configuration.Install.dll

Ruft den Namen des Protokolls ab, für das die Quelle festgelegt werden soll, oder legt diesen fest.

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };

[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=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set

Public Property Log As String

Eigenschaftswert

String

Der Name des Protokolls. Dabei kann es sich um einen Anwendungs-, einen System- oder einen benutzerdefinierten Protokollnamen handeln. Der Standardwert ist eine leere Zeichenfolge ("").

Attribute

TypeConverterAttribute

Hinweise

Sie können die Log -Eigenschaft verwenden, um die quelle, die Sie in der Source -Eigenschaft angeben, entweder einem vorhandenen Protokoll oder einem neuen Protokoll auf dem lokalen Computer zuzuordnen. Der 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 bei einem Ereignisprotokoll registrieren. Eine Ereignisquelle kann jeweils nur in ein Protokoll schreiben. Das Installationsprogramm verwendet den Wert der Source -Eigenschaft, um Ihre Anwendung im Ereignisprotokoll als gültige Quelle von Einträgen zu registrieren. Wenn Sie keinen Protokollnamen angeben, bevor das Installationsprogramm ausgeführt wird, 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 von Ihnen 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 in das Protokoll geschrieben wurde.

Das Betriebssystem speichert Ereignisprotokolle als Dateien. Wenn Sie oder die CreateEventSource -Methode verwendenEventLogInstaller, um ein neues Ereignisprotokoll zu 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.

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 registriert die Quelle nicht, wenn die Source Eigenschaft mit einem Quellnamen übereinstimmt, der bereits für das in der Log -Eigenschaft angegebene Ereignisprotokoll registriert ist.

Ausführlichere Informationen zum Verhalten von Ereignisprotokollen und Quellen finden Sie in der EventLog Klassendokumentation für die Log Eigenschaften und Source .

Weitere Informationen

• Log
• EventLog