Exportar (0) Imprimir
Expandir todo

EventLog.ModifyOverflowPolicy (Método)

Cambia el comportamiento configurado para la escritura de entradas nuevas cuando el registro de eventos alcanza su tamaño máximo de archivo.

Espacio de nombres: System.Diagnostics
Ensamblado: System (en system.dll)

[ComVisibleAttribute(false)] 
public void ModifyOverflowPolicy (
	OverflowAction action,
	int retentionDays
)
/** @attribute ComVisibleAttribute(false) */ 
public void ModifyOverflowPolicy (
	OverflowAction action, 
	int retentionDays
)
ComVisibleAttribute(false) 
public function ModifyOverflowPolicy (
	action : OverflowAction, 
	retentionDays : int
)
No aplicable.

Parámetros

action

Comportamiento de desbordamiento para la escritura de entradas nuevas en el registro de eventos.

retentionDays

Número mínimo de días que se conserva cada entrada del registro de eventos. Sólo se utiliza este parámetro si action se establece en OverwriteOlder.

Tipo de excepciónCondición

InvalidEnumArgumentException

action no es un valor OverflowAction válido.

ArgumentOutOfRangeException

retentionDays es menor que 1 o mayor que 365.

InvalidOperationException

Log no es un nombre de registro válido.

O bien

No se ha podido abrir en el equipo de destino la clave del Registro para el registro de eventos.

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.

NotaNota:

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 de 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.

NotaNota:

Esta propiedad representa una opción de configuración para el registro de eventos representado por esta instancia. Cuando el registro 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.

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.

Nota de precauciónPrecaució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);
    }
}

// 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.get_Log());
        OverflowAction logOverflow = inputLog.get_OverflowAction();
        int numDays = inputLog.get_MinimumRetentionDays();
        Console.WriteLine("  Current overflow setting = {0}",
            logOverflow.ToString());
        if (logOverflow.Equals(OverflowAction.OverwriteOlder)) {
            Console.WriteLine("\t Entries are retained a minimum of {0} "
                + "days.",((Int32)numDays).ToString());
        }

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

        // Change the overflow setting on the event log.
        if (logOverflow != inputLog.get_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);
    }        
} //ChangeEventLogOverflowAction

Windows 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft