OverflowAction Énumération

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paquet:

System.Diagnostics.EventLog v8.0.0

Source:

OverflowAction.cs

Spécifie comment gérer des entrées dans un journal des événements qui a atteint sa taille maximale.

C#

public enum OverflowAction

Héritage

Object

ValueType

Enum

OverflowAction

Champs

Nom	Valeur	Description
DoNotOverwrite	-1	Indique que les entrées existantes sont conservées lorsque le journal des événements est plein et que les nouvelles entrées sont ignorées.
OverwriteAsNeeded	0	Indique que chaque nouvelle entrée remplace l'entrée la plus ancienne lorsque le journal des événements est plein.
OverwriteOlder	1	Indique que les nouveaux événements remplacent des événements plus anciens que ceux spécifiés par la valeur de la propriété MinimumRetentionDays lorsque le journal des événements est plein. Les nouveaux événements sont ignorés si le journal des événements est plein et s'il n'existe pas d'événements plus anciens que ceux spécifiés par la valeur de la propriété MinimumRetentionDays.

Exemples

L’exemple suivant énumère les journaux des événements définis sur l’ordinateur local et affiche les détails de configuration de chaque journal des événements.

C#

static void DisplayEventLogProperties()
{
    // Iterate through the current set of event log files,
    // displaying the property settings for each file.

    EventLog[] eventLogs = EventLog.GetEventLogs();
    foreach (EventLog e in eventLogs)
    {
        Int64 sizeKB = 0;

        Console.WriteLine();
        Console.WriteLine("{0}:", e.LogDisplayName);
        Console.WriteLine("  Log name = \t\t {0}", e.Log);

        Console.WriteLine("  Number of event log entries = {0}", e.Entries.Count.ToString());

        // Determine if there is an event log file for this event log.
        RegistryKey regEventLog = Registry.LocalMachine.OpenSubKey("System\\CurrentControlSet\\Services\\EventLog\\" + e.Log);
        if (regEventLog != null)
        {
            Object temp = regEventLog.GetValue("File");
            if (temp != null)
            {
                Console.WriteLine("  Log file path = \t {0}", temp.ToString());
                FileInfo file = new FileInfo(temp.ToString());

                // Get the current size of the event log file.
                if (file.Exists)
                {
                    sizeKB = file.Length / 1024;
                    if ((file.Length % 1024) != 0)
                    {
                        sizeKB++;
                    }
                    Console.WriteLine("  Current size = \t {0} kilobytes", sizeKB.ToString());
                }
            }
            else
            {
                Console.WriteLine("  Log file path = \t <not set>");
            }
        }

        // Display the maximum size and overflow settings.

        sizeKB = e.MaximumKilobytes;
        Console.WriteLine("  Maximum size = \t {0} kilobytes", sizeKB.ToString());
        Console.WriteLine("  Overflow setting = \t {0}", e.OverflowAction.ToString());

        switch (e.OverflowAction)
        {
            case OverflowAction.OverwriteOlder:
                Console.WriteLine("\t Entries are retained a minimum of {0} days.",
                    e.MinimumRetentionDays);
                break;
            case OverflowAction.DoNotOverwrite:
                Console.WriteLine("\t Older entries are not overwritten.");
                break;
            case OverflowAction.OverwriteAsNeeded:
                Console.WriteLine("\t If number of entries equals max size limit, a new event log entry overwrites the oldest entry.");
                break;
            default:
                break;
        }
    }
}

Remarques

Chaque journal des événements a une limite de taille maximale et un paramètre configurable qui fournit la règle d’écriture de nouvelles entrées à cette limite. Lorsque le journal des événements a atteint sa taille maximale, vous pouvez spécifier l’une des règles suivantes :

• Les nouvelles entrées seront ignorées.

• Les nouvelles entrées remplacent les anciennes entrées.

• Les nouvelles entrées sont ignorées ou remplacent les entrées existantes en fonction de l’âge des entrées existantes.

Utilisez la ModifyOverflowPolicy méthode pour définir le comportement de dépassement de capacité pour un EventLog. Vérifiez le comportement configuré actuel d’un via EventLog sa OverflowAction propriété .

S’applique à