EventLog.Clear 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.
Entfernt alle Einträge aus dem Ereignisprotokoll.
public:
void Clear();public void Clear();member this.Clear : unit -> unitPublic Sub Clear ()Ausnahmen
Das Ereignisprotokoll wurde nicht erfolgreich gelöscht.
-oder-
Das Protokoll kann nicht geöffnet werden. Ein Windows-Fehlercode ist nicht verfügbar.
Für die Log Eigenschaft wird kein Wert angegeben. Stellen Sie sicher, dass der Protokollname keine leere Zeichenfolge ist.
Das Protokoll ist nicht vorhanden.
Beispiele
Im folgenden Beispiel wird ein Ereignisprotokoll gelöscht.
Vorsicht
Da Anwendungs-, System-, Sicherheits- und andere nicht benutzerdefinierte Protokolle wichtige Informationen enthalten können; Achten Sie darauf, ein benutzerdefiniertes Protokoll anzugeben, bevor Sie diesen Beispielcode ausführen. In diesem Beispiel wird das benutzerdefinierte Protokoll myNewLoggelöscht.
using System;
using System.Diagnostics;
using System.Threading;
class MySample{
public static void Main(){
// Create an EventLog instance and assign its log name.
EventLog myLog = new EventLog();
myLog.Log = "myNewLog";
myLog.Clear();
}
}
Option Explicit
Option Strict
Imports System.Diagnostics
Imports System.Threading
Class MySample
Public Shared Sub Main()
' Create an EventLog instance and assign its log name.
Dim myLog As New EventLog()
myLog.Log = "myNewLog"
myLog.Clear()
End Sub
End Class
Hinweise
Ereignisprotokolle werden mit einer maximalen Größe festgelegt, die bestimmt, wie viele Einträge sie enthalten können. Wenn ein Ereignisprotokoll voll ist, beendet es die Aufzeichnung neuer Ereignisinformationen oder beginnt, frühere Einträge zu überschreiben. Wenn die Ereignisaufzeichnung beendet wird, können Sie diese Methode verwenden, um das Protokoll vorhandener Einträge zu löschen und die Aufzeichnung von Ereignissen erneut zu starten. Sie müssen über Administratorberechtigungen für den Computer verfügen, auf dem sich das Protokoll befindet, um Ereignisprotokolleinträge zu löschen.
Clear schließt das Ereignisprotokoll, gibt die Ereignishandles frei, ruft neue Lese- und Schreibhandles ab und öffnet das Ereignisprotokoll erneut. Ereignisse, die nach dem Aufruf der Methode empfangen wurden, werden zusammen mit den vorhandenen Ereignissen nicht gelöscht.
