EventLog.Log Eigenschaft

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

[System.ComponentModel.SettingsBindable(true)]
public string Log { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }

[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.Log : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set

Public Property Log As String

Eigenschaftswert

Der Name des Protokolls. Dies kann ein Anwendungs-, System-, Sicherheits- oder benutzerdefinierter Protokollname sein. Der Standardwert ist eine leere Zeichenfolge ("").

Attribute

SettingsBindableAttribute TypeConverterAttribute

Beispiele

Im folgenden Beispiel werden Einträge im Ereignisprotokoll "NewEventLog" auf dem lokalen Computer gelesen.

using System;
using System.Diagnostics;

class MySample{

    public static void Main(){

        EventLog myNewLog = new EventLog();
        myNewLog.Log = "NewEventLog";
        foreach(EventLogEntry entry in myNewLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }
    }
}

Imports System.Diagnostics

Class MySample
    Public Shared Sub Main()
        Dim myNewLog As New EventLog()
        myNewLog.Log = "NewEventLog"
        Dim entry As EventLogEntry
        For Each entry In  myNewLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry: " & entry.Message))
        Next entry
    End Sub
End Class

Hinweise

Auf dem Server sind standardmäßig drei Protokolldateien vorhanden: Anwendung, System und Sicherheit. Anwendungen und Dienste verwenden die Anwendungsprotokolldatei. Gerätetreiber verwenden die Systemprotokolldatei. Das System generiert Erfolgs- und Fehlerüberwachungsereignisse im Sicherheitsprotokoll, wenn die Überwachung aktiviert ist. Wenn Sie andere Anwendungen installiert haben, z. B. Active Directory auf Windows-Servern, gibt es möglicherweise andere Standardprotokolldateien. Darüber hinaus können Sie benutzerdefinierte Protokolldateien auf einem lokalen oder Remotecomputer erstellen. Benutzerdefinierte Protokolle helfen ihnen, Ihre Einträge detaillierter zu organisieren, als zulässig ist, wenn Ihre Komponenten Ereignisse in das Standardanwendungsprotokoll schreiben.

Wenn Sie in ein Ereignisprotokoll schreiben, reicht es nicht aus, die Log Eigenschaft anzugeben. Sie müssen ihrer Ereignisprotokollressource eine Source Eigenschaft zuordnen, um sie mit einem bestimmten Protokoll zu verbinden. Es ist nicht erforderlich, einen Source Zeitpunkt anzugeben, wenn nur aus einem Protokoll gelesen wird, aber eine Ereignisquelle muss der Ereignisprotokollressource in der Registrierung des Servers zugeordnet sein. Sie können nur den Log Namen und MachineName (Servercomputernamen) angeben, der daraus gelesen werden soll.

Wenn die Source Eigenschaft nicht angegeben wurde, wird eine Log leere Zeichenfolge zurückgegeben, wenn Log sie nicht explizit festgelegt wurde (durch Festlegen der Log Eigenschaft oder über den Konstruktor). Wenn der Source Wert angegeben wurde, wird der Name des Protokolls zurückgegeben, Log in dem diese Quelle registriert wurde.

Eine Quelle kann nur jeweils in einem Protokoll registriert werden. Wenn die Source Eigenschaft für eine Instanz von EventLogfestgelegt wurde, können Sie die Log Eigenschaft dafür EventLog nicht ändern, ohne zuerst den Wert oder den Aufruf zu SourceDeleteEventSource ändern. Wenn Sie die Log Eigenschaft ändern, nachdem die Source Eigenschaft festgelegt wurde, löst das Schreiben eines Protokolleintrags eine Ausnahme aus.

Das Betriebssystem speichert Ereignisprotokolle als Dateien. Wenn Sie ein neues Ereignisprotokoll verwenden EventLogInstaller oder CreateEventSource 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.

Sie können ein neues Protokoll nicht allein mithilfe der Log Eigenschaft erstellen (ohne eine Quelle für das Protokoll anzugeben). Sie können einen neuen Protokollnamen als Parameter aufrufen CreateEventSourceund dann aufrufen DeleteEventSource. Die Absicht besteht jedoch in der Regel darin, neue anwendungsspezifische Protokolle zu erstellen (und einträge zu schreiben) oder aus vorhandenen Protokollen zu lesen.

Wenn sich der Log Wert ändert, wird das Ereignisprotokoll geschlossen, und alle Ereignishandles werden freigegeben.

Weitere Informationen

• MachineName
• Source
• Entries
• Exists(String)
• Delete(String)
• CreateEventSource
• EventLogEntryCollection