EventLog.Clear Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paquet:

System.Diagnostics.EventLog v8.0.0

Source:

EventLog.cs

Supprime toutes les entrées du journal des événements.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Exceptions

Win32Exception

L'effacement du journal des événements a échoué.

- ou -

Impossible d'ouvrir le journal. Un code d'erreur Windows n'est pas disponible.

ArgumentException

Il n'y a pas de valeur spécifiée pour la propriété Log. Veillez à ce que le nom de journal ne soit pas une chaîne vide.

InvalidOperationException

Le journal n'existe pas.

Exemples

L’exemple suivant efface un journal des événements.

Attention

Étant donné que les journaux d’application, système, sécurité et autres journaux non personnalisés peuvent contenir des informations cruciales ; veillez à spécifier un journal personnalisé avant d’exécuter cet exemple de code. Cet exemple supprime le journal myNewLogpersonnalisé .

#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

Remarques

Les journaux d’événements sont définis avec une taille maximale qui détermine le nombre d’entrées qu’ils peuvent contenir. Lorsqu’un journal des événements est plein, il cesse d’enregistrer les nouvelles informations d’événement ou commence à remplacer les entrées antérieures. Si l’enregistrement des événements s’arrête, vous pouvez utiliser cette méthode pour effacer le journal des entrées existantes et lui permettre de recommencer l’enregistrement des événements. Vous devez disposer des autorisations d’administrateur sur l’ordinateur sur lequel réside le journal pour effacer les entrées du journal des événements.

Clear ferme le journal des événements, libère les handles d’événements, récupère les nouveaux handles de lecture et d’écriture et rouvre le journal des événements. Les événements reçus après l’appel à la méthode ne sont pas effacés avec les événements existants.

Voir aussi

• Close()
• Delete(String)