EventLog.Clear Methode

  • Referenz

Definition

Namespace:
System.Diagnostics
Assembly:
System.Diagnostics.EventLog.dll
Assembly:
System.dll

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 Application, System, Security 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 vollständig ist, wird die Aufzeichnung neuer Ereignisinformationen beendet 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 es zu ermöglichen, die Aufzeichnung von Ereignissen erneut zu starten. Sie müssen Administratorberechtigungen für den Computer haben, auf dem sich das Protokoll befindet, um Ereignisprotokolleinträge zu löschen.

Clear schließt das Ereignisprotokoll, veröffentlicht die Ereignishandles, ruft neue Lese- und Schreibvorgänge ab und öffnet das Ereignisprotokoll erneut. Ereignisse, die nach dem Aufruf der Methode empfangen wurden, werden zusammen mit den vorhandenen Ereignissen nicht gelöscht.

Gilt für

Siehe auch