EventLogInstaller.Log-Eigenschaft

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

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

Syntax

'Declaration
Public Property Log As String
'Usage
Dim instance As EventLogInstaller
Dim value As String

value = instance.Log

instance.Log = value

public string Log { get; set; }

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

/** @property */
public String get_Log ()

/** @property */
public void set_Log (String value)

public function get Log () : String

public function set Log (value : String)

Eigenschaftenwert

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

Hinweise

Mithilfe der Log-Eigenschaft können Sie die in der Source-Eigenschaft angegebene Quelle entweder einem bereits vorhandenen Protokoll oder einem neuen Protokoll auf dem lokalen Computer zuordnen. Anhand dieser Informationen ordnet Installer-Tool (Installutil.exe) die Quelle dem Protokoll in der Registrierung des Computers zu. Anwendungen und Dienste schreiben in das Anwendungsprotokoll oder ein benutzerdefiniertes Protokoll. Gerätetreiber schreiben i. d. R. in das Systemprotokoll.

Um Einträge in ein Ereignisprotokoll schreiben zu können, muss zuerst eine Quelle erstellt und für ein Ereignisprotokoll registriert werden. Eine Ereignisquelle kann nur in ein Protokoll gleichzeitig schreiben. Das Installationsprogramm registriert mithilfe des Werts der Source-Eigenschaft die Anwendung im Ereignisprotokoll als gültige Quelle für Einträge. Wenn Sie vor dem Ausführen des Installationsprogramms keinen Protokollnamen angeben, registriert das Installationsprogramm die Quelle im Anwendungsprotokoll. Wenn Sie eine neue Quelle und ein bereits vorhandenes Protokoll angeben, erstellt das Installationsprogramm eine neue Ereignisquelle und ordnet diese 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. Das Protokoll wird jedoch erst erstellt, wenn der erste Eintrag in dieses geschrieben wird.

Das Betriebssystem speichert Ereignisprotokolle als Dateien. Wenn Sie ein neues Ereignisprotokoll mit EventLogInstaller oder der CreateEventSource-Methode erstellen, wird die zugeordnete Datei auf dem angegebenen Computer im Verzeichnis %SystemRoot%\System32\Config gespeichert. Der Dateiname setzt sich aus den ersten acht Zeichen der Log-Eigenschaft und der Dateinamenerweiterung ".evt" zusammen.

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

Weitere Informationen zum Verhalten von Ereignisprotokollen und -quellen finden Sie in der Dokumentation der EventLog-Klasse für die Log-Eigenschaft und die Source-Eigenschaft.

.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
EventLog.Log-Eigenschaft
EventLog-Klasse