EventLog.Clear Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Diagnostics

Assembly:: System.Diagnostics.EventLog.dll

Assembly:: System.dll

Pacchetto:: System.Diagnostics.EventLog v6.0.0

Pacchetto:: System.Diagnostics.EventLog v7.0.0

Pacchetto:: System.Diagnostics.EventLog v8.0.0

Pacchetto:: System.Diagnostics.EventLog v9.0.0-preview.2.24128.5

Origine:: EventLog.cs

Origine:: EventLog.cs

Origine:: EventLog.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rimuove tutte le voci dal registro eventi.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Eccezioni

Win32Exception

La cancellazione del log eventi non è stata eseguita correttamente.

-oppure-

È impossibile aprire il log. Non è disponibile un codice di errore di Windows.

ArgumentException

Non è specificato un valore per la proprietà Log. Verificare che il nome del log non corrisponda a una stringa vuota.

InvalidOperationException

Il log non è presente.

Esempio

Nell'esempio seguente viene cancellato un registro eventi.

Attenzione

Poiché applicazioni, sistema, sicurezza e altri log non personalizzati possono contenere informazioni cruciali; assicurarsi di specificare un log personalizzato prima di eseguire questo codice di esempio. In questo esempio viene eliminato il log myNewLogpersonalizzato.

#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

Commenti

I log eventi vengono impostati con dimensioni massime che determinano il numero di voci che possono contenere. Quando un registro eventi è completo, interrompe la registrazione di nuove informazioni sull'evento o inizia a sovrascrivere le voci precedenti. Se la registrazione degli eventi si arresta, è possibile usare questo metodo per cancellare il log delle voci esistenti e consentire di avviare di nuovo gli eventi di registrazione. È necessario disporre delle autorizzazioni di amministratore per il computer in cui risiede il log per cancellare le voci del log eventi.

Clear chiude il registro eventi, rilascia gli handle eventi, recupera nuovi handle di lettura e scrittura e riapri il log eventi. Gli eventi ricevuti dopo la chiamata al metodo non vengono cancellati insieme agli eventi esistenti.

Si applica a

Prodotto	Versioni
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Condividi tramite