EventLog.Clear Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Quita todas las entradas del registro de eventos.
public:
void Clear();
public void Clear ();
member this.Clear : unit -> unit
Public Sub Clear ()
Excepciones
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.
No se especifica un valor para la propiedad Log. Asegúrese de que el nombre del Registro no es una cadena vacía.
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 myNewLog
personalizado .
#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.