EventLog.ModifyOverflowPolicy(OverflowAction, Int32) EventLog.ModifyOverflowPolicy(OverflowAction, Int32) EventLog.ModifyOverflowPolicy(OverflowAction, Int32) EventLog.ModifyOverflowPolicy(OverflowAction, Int32) Method

Definición

Cambia el comportamiento configurado para la escritura de entradas nuevas cuando el registro de eventos alcanza su tamaño máximo de archivo.Changes the configured behavior for writing new entries when the event log reaches its maximum file size.

public:
 void ModifyOverflowPolicy(System::Diagnostics::OverflowAction action, int retentionDays);
[System.Runtime.InteropServices.ComVisible(false)]
public void ModifyOverflowPolicy (System.Diagnostics.OverflowAction action, int retentionDays);
member this.ModifyOverflowPolicy : System.Diagnostics.OverflowAction * int -> unit
Public Sub ModifyOverflowPolicy (action As OverflowAction, retentionDays As Integer)

Parámetros

action
OverflowAction OverflowAction OverflowAction OverflowAction

Comportamiento de desbordamiento para la escritura de entradas nuevas en el registro de eventos.The overflow behavior for writing new entries to the event log.

retentionDays
Int32 Int32 Int32 Int32

Número mínimo de días que se conserva cada entrada del registro de eventos.The minimum number of days each event log entry is retained. Solo se utiliza este parámetro si action se establece en OverwriteOlder.This parameter is used only if action is set to OverwriteOlder.

Excepciones

retentionDays es menor que 1 o mayor que 365.retentionDays is less than one, or larger than 365.

Log no es un nombre de registro válido.The Log value is not a valid log name.

O bien-or- No se ha podido abrir en el equipo de destino la clave del Registro para el registro de eventos.The registry key for the event log could not be opened on the target computer.

Ejemplos

El ejemplo siguiente muestra la directiva de desbordamiento configurado para un registro de eventos especificado y permite al usuario seleccionar una nueva configuración de directiva de desbordamiento para el registro de eventos.The following example displays the configured overflow policy for a specified event log, and allows the user to select a new overflow policy setting for the event log.

// Display the current event log overflow settings, and 
// prompt the user to input a new overflow setting.
void ChangeEventLogOverflowAction( String^ logName )
{
   if ( EventLog::Exists( logName ) )
   {
      
      // Display the current overflow setting of the 
      // specified event log.
      EventLog^ inputLog = gcnew EventLog( logName );
      Console::WriteLine( "  Event log {0}", inputLog->Log );
      OverflowAction logOverflow = inputLog->OverflowAction;
      Int32 numDays = inputLog->MinimumRetentionDays;
      Console::WriteLine( "  Current overflow setting = {0}", logOverflow );
      if ( logOverflow == OverflowAction::OverwriteOlder )
      {
         Console::WriteLine( "\t Entries are retained a minimum of {0} days.", numDays );
      }
      
      // Prompt user for a new overflow setting.
      GetNewOverflowSetting(  &logOverflow,  &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.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.
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

Comentarios

El comportamiento de desbordamiento para un registro de eventos especifica lo que sucede cuando las entradas nuevas se escriban en un registro que se ha alcanzado su tamaño máximo de archivo.The overflow behavior for an event log specifies what happens when new entries are to be written to a log that has reached its maximum file size.

Nota

El comportamiento de desbordamiento surte efecto sólo cuando un registro de eventos alcanza su tamaño máximo de archivo.The overflow behavior takes effect only when an event log reaches its maximum file size. El comportamiento de desbordamiento no afecta a escribir una nueva entrada en un registro que puede dar cabida a las entradas de registro de eventos adicional.The overflow behavior does not affect writing a new entry to a log that can accommodate additional event log entries.

El ModifyOverflowPolicy método configura el comportamiento de desbordamiento de un registro de eventos.The ModifyOverflowPolicy method configures the overflow behavior of an event log. EventLog instancia de.EventLog instance. Después de llamar a este método para el registro de eventos especificado por el Log propiedad, el OverflowAction y MinimumRetentionDays los valores de propiedad reflejan el comportamiento de desbordamiento recién configurado.After calling this method for the event log specified by the Log property, the OverflowAction and MinimumRetentionDays property values reflect the newly configured overflow behavior.

Nota

Esta propiedad representa un valor de configuración para el registro de eventos representado por esta instancia.This property represents a configuration setting for the event log represented by this instance. Cuando el registro de eventos alcanza su tamaño máximo, esta propiedad especifica cómo el sistema operativo controla las nuevas entradas escritas por todos los orígenes de eventos registrados para el registro de eventos.When the event log reaches its maximum size, this property specifies how the operating system handles new entries written by all event sources registered for the event log.

Establecer el action parámetro OverwriteAsNeeded para indicar que una nueva entrada sobrescribe la entrada más antigua cuando el EventLog alcanza su tamaño máximo.Set the action parameter to OverwriteAsNeeded to indicate that a new entry overwrites the oldest entry when the EventLog reaches its maximum size. Si el action parámetro está establecido en OverwriteAsNeeded, el retentionDays se omite el valor del parámetro.If the action parameter is set to OverwriteAsNeeded, the retentionDays parameter value is ignored.

Establecer el action parámetro OverwriteOlder para indicar que cada entrada nueva sobrescribirá las entradas más antiguas cuando el EventLog alcanza su tamaño máximo.Set the action parameter to OverwriteOlder to indicate that each new entry overwrites older entries when the EventLog reaches its maximum size. Especifique el número de días que deben conservarse los eventos en el registro usando el retentionDays parámetro.Specify the number of days that events must be retained in the log using the retentionDays parameter. Los eventos escritos en el intervalo de retención no se sobrescriben con nuevas entradas.Events written within the retention range are not overwritten by new entries.

Establecer el action parámetro DoNotOverwrite descartar nuevos eventos cuando se alcanza el tamaño máximo del registro.Set the action parameter to DoNotOverwrite to discard new events when the maximum log size is reached. Si el action parámetro está establecido en DoNotOverwrite, el retentionDays se omite el valor del parámetro.If the action parameter is set to DoNotOverwrite, the retentionDays parameter value is ignored.

Precaución

Establecer la directiva de desbordamiento en DoNotOverwrite especifica que se descartan las entradas nuevas cuando el registro de eventos está lleno.Setting the overflow policy to DoNotOverwrite specifies that new entries are discarded when the event log is full. Si usa esta opción, asegúrese del registro de eventos con regularidad es archivar y borrar para evitar que alcance su límite de tamaño máximo.If you use this setting, ensure the event log is regularly archived and cleared to avoid reaching its maximum size limit.

Seguridad

EventLogPermission
para administrar la información de registro de eventos en el equipo.for administering event log information on the computer. Enumeración asociada: AdministerAssociated enumeration: Administer

Se aplica a

Consulte también: