OverflowAction Enumeración

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.EventLog.dll

Paquete:

System.Diagnostics.EventLog v8.0.0

Source:

OverflowAction.cs

Especifica el modo de tratar las entradas de un registro de eventos que ha alcanzado el tamaño de archivo máximo.

C#

public enum OverflowAction

Herencia

Object

ValueType

Enum

OverflowAction

Campos

Nombre	Valor	Description
DoNotOverwrite	-1	Indica que las entradas existentes se retienen cuando el registro de eventos está lleno y las entradas nuevas se descartan.
OverwriteAsNeeded	0	Indica que cada nueva entrada sobrescribe la más antigua cuando el registro de eventos está lleno.
OverwriteOlder	1	Indica que los nuevos eventos sobrescriben los eventos anteriores a los especificados en el valor de la propiedad MinimumRetentionDays cuando el registro de eventos se llena. Los eventos nuevos se descartan si el registro de eventos está lleno y no hay eventos anteriores a los especificados en el valor de la propiedad MinimumRetentionDays.

Ejemplos

En el ejemplo siguiente se enumeran los registros de eventos definidos en el equipo local y se muestran los detalles de configuración de cada registro de eventos.

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;
        }
    }
}

Comentarios

Cada registro de eventos tiene un límite de tamaño máximo y una configuración configurable que proporciona la regla para escribir nuevas entradas en ese límite. Cuando el registro de eventos haya alcanzado su tamaño máximo, puede especificar una de las reglas siguientes:

• Se descartarán las nuevas entradas.

• Las nuevas entradas sobrescribirán las entradas anteriores.

• Las nuevas entradas se descartarán o sobrescribirán las entradas existentes en función de la antigüedad de las entradas existentes.

Use el ModifyOverflowPolicy método para establecer el comportamiento de desbordamiento de un .EventLog Compruebe el comportamiento configurado actual de a EventLog través de su OverflowAction propiedad .

Se aplica a