Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método EventLog.ModifyOverflowPolicy (OverflowAction, Int32)

 

Publicado: octubre de 2016

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 Sub ModifyOverflowPolicy (
	action As OverflowAction,
	retentionDays As Integer
)

Parámetros

action
Type: System.Diagnostics.OverflowAction

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

retentionDays
Type: System.Int32

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

Exception Condition
InvalidEnumArgumentException

action no es un valor OverflowAction válido.

ArgumentOutOfRangeException

retentionDays es menor que 1 o mayor que 365.

InvalidOperationException

El Log valor no es un nombre de registro válido.

o bien

No se pudo abrir la clave del registro para el registro de eventos en el equipo de destino.

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

System_CAPS_noteNota

El comportamiento de desbordamiento sólo surte efecto cuando un registro de eventos alcanza su tamaño máximo de archivo. El comportamiento de desbordamiento no afecta a la escritura de una nueva entrada en un registro que puede adaptarse a las entradas de registro de eventos adicionales.

El ModifyOverflowPolicy método configura el comportamiento de desbordamiento de un registro de eventos. EventLog instancia. Después de llamar a este método para el registro de eventos especificado por el Log propiedad, el OverflowAction y MinimumRetentionDays valores propiedades reflejan el comportamiento recién configurado.

System_CAPS_noteNota

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 cómo el sistema operativo controla entradas nuevas que escriban todos los orígenes registrados para el registro de eventos.

Establecer el action parámetro OverwriteAsNeeded para indicar que una entrada nueva sobrescribirá la entrada más antigua cuando el EventLog alcanza su tamaño máximo. Si el action parámetro se establece en OverwriteAsNeeded, el retentionDays se omite el valor del parámetro.

Establecer el action parámetro OverwriteOlder para indicar que cada entrada nueva sobrescribirá las entradas más antiguas cuando la EventLog alcanza su tamaño máximo. Especifique el número de días que deben conservarse los sucesos en el registro mediante el retentionDays parámetro. Los eventos escritos en el intervalo de retención no se sobrescriben con nuevas entradas.

Establecer el action parámetro DoNotOverwrite para descartar los eventos nuevos cuando se alcanza el tamaño máximo del registro. Si el action parámetro se establece en DoNotOverwrite, el retentionDays se omite el valor del parámetro.

System_CAPS_cautionPrecaución

Establecer la directiva de desbordamiento en DoNotOverwrite Especifica que se descartarán las entradas nuevas cuando el registro de eventos está lleno. Si utiliza esta opción, asegúrese del registro de eventos con regularidad se archivan y borrado para evitar que se alcance el límite de tamaño máximo.

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

' Display the current event log overflow settings, and 
' prompt the user to input a new overflow setting.
Shared Sub ChangeEventLogOverflowAction(logName As String)

    If EventLog.Exists(logName) Then 
        Dim inputLog As EventLog = New EventLog(logName)
        Console.WriteLine("  Event log {0}", inputLog.Log)

        Dim logOverflow As OverflowAction = inputLog.OverflowAction
        Dim numDays As Int32 = inputLog.MinimumRetentionDays

        Console.WriteLine("  Current overflow setting = {0}", _
                          logOverflow.ToString())

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

        If Not logOverflow = inputLog.OverflowAction Then
            inputLog.ModifyOverflowPolicy(logOverflow, numDays)
            Console.WriteLine("Event log overflow policy was modified successfully!")
        Else
            Console.WriteLine("Event log overflow policy was not modified.")
        End If

    Else
        Console.WriteLine("Event log {0} was not found.", logName)
    End If

End Sub

EventLogPermission

for administering event log information on the computer. Associated enumeration: F:System.Diagnostics.EventLogPermissionAccess.Administer

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: