EventLog.Clear Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Quelle:

EventLog.cs

Entfernt alle Einträge aus dem Ereignisprotokoll.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Ausnahmen

Win32Exception

Das Ereignisprotokoll wurde nicht erfolgreich gelöscht.

- oder -

Das Protokoll kann nicht geöffnet werden. Es ist kein Windows-Fehlercode verfügbar.

ArgumentException

Für die Log-Eigenschaft wurde kein Wert angegeben. Stellen Sie sicher, dass der Protokollname keine leere Zeichenfolge ist.

InvalidOperationException

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.

Weitere Informationen

• Close()
• Delete(String)