EventLog.Clear Metodo
Definizione
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 -> unitPublic Sub Clear ()Eccezioni
Il registro eventi non è stato cancellato correttamente.
oppure
Impossibile aprire il log. Codice di errore di Windows non disponibile.
Non viene specificato un valore per la Log proprietà . Assicurarsi che il nome del log non sia una stringa vuota.
Il log non esiste.
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;
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 una dimensione massima che determina il numero di voci che possono contenere. Quando un registro eventi è pieno, 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 nuovamente la registrazione degli eventi. È necessario disporre delle autorizzazioni di amministratore per il computer in cui risiede il log per cancellare le voci del registro eventi.
Clear chiude il registro eventi, rilascia gli handle di evento, recupera nuovi handle di lettura e scrittura e riapre il registro eventi. Gli eventi ricevuti dopo la chiamata al metodo non vengono cancellati insieme agli eventi esistenti.
