EventLog.Clear Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Pacote:

System.Diagnostics.EventLog v8.0.0

Origem:

EventLog.cs

Remove todas as entradas do log de eventos.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Exceções

Win32Exception

Não foi possível limpar o log de eventos.

- ou -

Não é possível abrir o log. Um código de erro do Windows não está disponível.

ArgumentException

Não há valor especificado para a propriedade Log. Verifique se que o nome do log não é uma cadeia de caracteres vazia.

InvalidOperationException

Log inexistente.

Exemplos

O exemplo a seguir limpa um log de eventos.

Cuidado

Como o aplicativo, o sistema, a segurança e outros logs não personalizados podem conter informações cruciais; especifique um log personalizado antes de executar este código de exemplo. Este exemplo exclui o log 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

Comentários

Os logs de eventos são definidos com um tamanho máximo que determina quantas entradas eles podem conter. Quando um log de eventos está cheio, ele para de gravar novas informações de evento ou começa a substituir entradas anteriores. Se a gravação de eventos for interrompida, você poderá usar esse método para limpar o log de entradas existentes e permitir que ele inicie a gravação de eventos novamente. Você deve ter permissões de administrador para o computador no qual o log reside para limpar as entradas do log de eventos.

Clear fecha o log de eventos, libera os identificadores de evento, recupera novos identificadores de leitura e gravação e reabre o log de eventos. Os eventos recebidos após a chamada para o método não são limpos junto com os eventos existentes.

Confira também

• Close()
• Delete(String)