Freigeben über

EventLog.Clear-Methode

Entfernt alle Einträge aus dem Ereignisprotokoll.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public Sub Clear
'Usage
Dim instance As EventLog

instance.Clear

public void Clear ()

public:
void Clear ()

public void Clear ()

public function Clear ()

Ausnahmen

Ausnahmetyp Bedingung

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.

Hinweise

Ereignisprotokolle werden mit einer Maximalgröße festgelegt, die angibt, wie viele Einträge diese enthalten können. Wenn ein Ereignisprotokoll voll ist, werden entweder keine weiteren Ereignisinformationen mehr aufgezeichnet, oder frühere Einträge werden überschrieben. Wenn keine Ereignisse mehr aufgezeichnet werden, können Sie mit dieser Methode vorhandene Einträge aus dem Protokoll löschen und so die Aufzeichnung von Ereignissen wieder aufnehmen. Sie müssen über Administratorrechte für den Computer verfügen, auf dem das Protokoll gespeichert ist, 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. Nach dem Aufruf der Methode empfangene Ereignisse werden nicht gemeinsam mit den vorhandenen Ereignissen gelöscht.

Beispiel

Im folgenden Beispiel wird ein Ereignisprotokoll gelöscht.

Warnung

Da das Anwendungs-, das System-, das Sicherheits- und andere nicht benutzerdefinierte Protokolle wichtige Informationen enthalten können, müssen Sie sicherstellen, dass "mySource" in einem benutzerdefinierten Protokoll registriert ist, bevor Sie diesen Beispielcode ausführen.

Option Explicit
Option Strict

Imports System
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 'Main
End Class 'MySample

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();                                                                    
    }       
}
   

#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();
}

import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[] args)
    {
        // Create an EventLog instance and assign its log name.
        EventLog myLog = new EventLog();
        myLog.set_Log("myNewLog");
        myLog.Clear();
    } //main
} //MySample

.NET Framework-Sicherheit

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

EventLog-Klasse
EventLog-Member
System.Diagnostics-Namespace
Close
Delete

  • Last updated on