EventLog.Clear Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.EventLog.dll

Paquete:

System.Diagnostics.EventLog v8.0.0

Source:

EventLog.cs

Quita todas las entradas del registro de eventos.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Excepciones

Win32Exception

El registro de eventos no se ha borrado correctamente.

o bien

No puede abrirse el registro. No hay ningún código de error de Windows disponible.

ArgumentException

No se especifica un valor para la propiedad Log. Asegúrese de que el nombre del Registro no es una cadena vacía.

InvalidOperationException

El registro no existe.

Ejemplos

En el ejemplo siguiente se borra un registro de eventos.

Precaución

Dado que los registros de aplicación, sistema, seguridad y otros no personalizados pueden contener información crucial; Asegúrese de especificar un registro personalizado antes de ejecutar este código de ejemplo. En este ejemplo se elimina el registro myNewLogpersonalizado .

#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

Comentarios

Los registros de eventos se establecen con un tamaño máximo que determina cuántas entradas pueden contener. Cuando un registro de eventos está lleno, deja de grabar nueva información de eventos o comienza a sobrescribir las entradas anteriores. Si la grabación de eventos se detiene, puede usar este método para borrar el registro de entradas existentes y permitir que vuelva a iniciar la grabación de eventos. Debe tener permisos de administrador en el equipo en el que reside el registro para borrar las entradas del registro de eventos.

Clear cierra el registro de eventos, libera los identificadores de eventos, recupera nuevos identificadores de lectura y escritura y vuelve a abrir el registro de eventos. Los eventos recibidos después de la llamada al método no se borran junto con los eventos existentes.

Consulte también

• Close()
• Delete(String)