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
La cancellazione del log eventi non è stata eseguita correttamente.
-oppure-
È impossibile aprire il log. Non è disponibile un codice di errore di Windows.
Non è specificato un valore per la proprietà Log. Verificare che il nome del log non corrisponda a una stringa vuota.
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.
