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. Es ist kein Windows-Fehlercode verfügbar.
Für die Log-Eigenschaft wurde 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.
Achtung
Da Anwendungs-, System-, Sicherheits- und andere nicht benutzerdefinierte Protokolle wichtige Informationen enthalten können; Stellen Sie sicher, dass Sie ein benutzerdefiniertes Protokoll angeben, bevor Sie diesen Beispielcode ausführen. In diesem Beispiel wird das benutzerdefinierte Protokoll myNewLoggelöscht.
#using <System.dll>
using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
// Create an EventLog instance and assign its log name.
EventLog^ myLog = gcnew EventLog;
myLog->Log = "myNewLog";
myLog->Clear();
}
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, wird die Aufzeichnung neuer Ereignisinformationen beendet, oder es 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 zuzulassen, dass die Aufzeichnung von Ereignissen erneut gestartet wird. Sie müssen über Administratorberechtigungen für den Computer verfügen, auf dem sich das Protokoll befindet, um Ereignisprotokolleinträge löschen zu können.
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 werden, werden nicht zusammen mit den vorhandenen Ereignissen gelöscht.
