EventLog.Clear Méthode

Définition

Espace de noms:
System.Diagnostics
Assembly:
System.dll

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

Le journal des événements n’a pas été effacé avec succès.

-ou-

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

ArgumentException

Une valeur n’est pas spécifiée pour la Log propriété. Vérifiez que le nom du journal n’est pas une chaîne vide.

InvalidOperationException

Le journal n’existe pas.

Exemples

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

Avertissement

É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;
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 arrête d’enregistrer de 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 l’autoriser à recommencer l’enregistrement des événements. Vous devez disposer d’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 de nouveaux handles de lecture et d’écriture, puis rouvert 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.

S’applique à

Voir aussi