EventLog.Clear Método

Definição

Espaço de Nomes:
System.Diagnostics
Assemblagem:
System.dll

Remove todas as entradas do registo de eventos.

public:
 void Clear();
public void Clear();
member this.Clear : unit -> unit
Public Sub Clear ()

Exceções

Win32Exception

O registo de eventos não foi apagado com sucesso.

-ou-

O registo não pode ser aberto. Não existe código de erro do Windows.

ArgumentException

Não é especificado um valor para a Log propriedade. Certifica-te de que o nome do log não é uma string vazia.

InvalidOperationException

O registo não existe.

Exemplos

O exemplo seguinte limpa um registo de eventos.

Caution

Como os registos de Aplicação, Sistema, Segurança e outros não personalizados podem conter informação crucial; Certifique-se de especificar um registo personalizado antes de executar este código de exemplo. Este exemplo elimina o registo myNewLogpersonalizado .

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

Observações

Os registos de eventos são definidos com um tamanho máximo que determina quantas entradas podem conter. Quando um registo de eventos está cheio, deixa de registar novas informações de eventos ou começa a sobrescrever entradas anteriores. Se o registo de eventos parar, pode usar este método para limpar o registo de entradas existentes e permitir que volte a registar eventos. Deve ter permissões de administrador para o computador onde o registo reside para apagar as entradas do registo de eventos.

Clear fecha o registo de eventos, liberta os handles de eventos, recupera novos handles de leitura e escrita, e reabre o log de eventos. Os eventos recebidos após a chamada ao método não são aprovados juntamente com os eventos existentes.

Aplica-se a

Ver também