Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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
)

Parámetros

action
Tipo: System.Diagnostics.OverflowAction
Comportamiento de desbordamiento para la escritura de entradas nuevas en el registro de eventos.
retentionDays
Tipo: System.Int32
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.

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

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


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft