EventLog.ModifyOverflowPolicy (Método)

El comportamiento de desbordamiento de un registro de eventos especifica qué sucede cuando se escriben entradas nuevas en un registro que ha alcanzado su tamaño máximo de archivo.

Nota
El comportamiento de desbordamiento sólo se produce cuando el registro de eventos alcanza su tamaño de archivo máximo. El comportamiento de desbordamiento no afecta a la escritura de una nueva entrada en un registro de eventos que pueda alojar entradas adicionales.

El método ModifyOverflowPolicy configura el comportamiento de desbordamiento de un registro de evento. Instancia EventLog. Después de llamar a este método para el registro de eventos especificado por la propiedad Log, los valores de las propiedades OverflowAction y MinimumRetentionDays reflejarán el comportamiento recién configurado.

Nota
Esta propiedad representa una opción de configuración para el registro de eventos representado por esta instancia. Cuando el registro de eventos alcanza su tamaño máximo, esta propiedad especifica la forma en que el sistema operativo ha de controlar las entradas nuevas que escriban todos los orígenes registrados para el registro de eventos.

El parámetro action deberá establecerse en OverwriteAsNeeded para indicar que cada entrada nueva sobrescribirá a la entrada más antigua cuando EventLog haya alcanzado su tamaño máximo. Si el parámetro action se establece en OverwriteAsNeeded, se omitirá el valor del parámetro retentionDays.

El parámetro action deberá establecerse en OverwriteOlder para indicar que cada entrada nueva sobrescribirá a las más antiguas cuando EventLog haya alcanzado su tamaño máximo. Para especificar el número de días que se deben conservar los eventos en el registro, deberá utilizarse el parámetro retentionDays. Los eventos escritos en el período de retención no serán sobrescritos por las entradas nuevas.

El parámetro action deberá establecerse en DoNotOverwrite para descartar los eventos nuevos una vez alcanzado el tamaño máximo de archivo. Si el parámetro action se establece en DoNotOverwrite, se omitirá el valor del parámetro retentionDays.

Precaución
Establecer la directiva de desbordamiento en DoNotOverwrite hará que las entradas nuevas queden descartadas cuando el registro de eventos esté lleno. Si va a utilizar esta configuración, asegúrese de archivar y borrar el registro de eventos regularmente para evitar que alcance su tamaño máximo.

En el siguiente ejemplo se muestra la directiva de desbordamiento configurada para un registro de eventos especificado y se le permite al usuario seleccionar otra configuración de desbordamiento para el mismo registro.

// Display the current event log overflow settings, and 
// prompt the user to input a new overflow setting.
public static void ChangeEventLogOverflowAction(String logName)
{
    if (EventLog.Exists(logName))
    {
        // Display the current overflow setting of the 
        // specified event log.
        EventLog inputLog = new EventLog(logName);
        Console.WriteLine("  Event log {0}", inputLog.Log);

        OverflowAction logOverflow = inputLog.OverflowAction;
        Int32 numDays = inputLog.MinimumRetentionDays;

        Console.WriteLine("  Current overflow setting = {0}",
            logOverflow.ToString());
        if (logOverflow == OverflowAction.OverwriteOlder)
        {
            Console.WriteLine("\t Entries are retained a minimum of {0} days.", 
                numDays.ToString());
        }

        // Prompt user for a new overflow setting.
        GetNewOverflowSetting(ref logOverflow, ref numDays);

        // Change the overflow setting on the event log.
        if (logOverflow != inputLog.OverflowAction)
        {
            inputLog.ModifyOverflowPolicy(logOverflow, numDays);
            Console.WriteLine("Event log overflow policy was modified successfully!");
        }
        else 
        {
            Console.WriteLine("Event log overflow policy was not modified.");
        }
    }
    else 
    {
        Console.WriteLine("Event log {0} was not found.", logName);
    }
}

.NET Framework

.NET Framework Client Profile

• EventLogPermission 

  para administrar la información del registro de eventos en el equipo. Enumeración asociada: EventLogPermissionAccess.Administer

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia