EventLog.ModifyOverflowPolicy(OverflowAction, Int32) Metodo

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Origine:

EventLog.cs

Modifica il comportamento configurato per la scrittura di nuove voci quando il registro eventi raggiunge le dimensioni massime del file.

public:
 void ModifyOverflowPolicy(System::Diagnostics::OverflowAction action, int retentionDays);

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)

Parametri

action

OverflowAction

Comportamento di overflow per la scrittura di nuove voci nel registro eventi. Non deve essere OverwriteOlder.

retentionDays

Int32

Deprecated. Deve essere 0.

Eccezioni

InvalidEnumArgumentException

action non è un valore valido OverflowAction .

ArgumentOutOfRangeException

retentionDays è minore di uno o maggiore di 365.

InvalidOperationException

Il Log valore non è un nome di log valido.

oppure

Impossibile aprire la chiave del Registro di sistema per il registro eventi nel computer di destinazione.

Esempio

Nell'esempio seguente vengono visualizzati i criteri di overflow configurati per un registro eventi specificato e consente all'utente di selezionare una nuova impostazione dei criteri di overflow per il registro eventi.

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

Commenti

Il comportamento di overflow per un registro eventi specifica cosa accade quando le nuove voci devono essere scritte in un log che ha raggiunto le dimensioni massime del file.

Annotazioni

Il comportamento dell'overflow diventa effettivo solo quando un registro eventi raggiunge le dimensioni massime del file. Il comportamento dell'overflow non influisce sulla scrittura di una nuova voce in un log che può contenere voci aggiuntive del registro eventi.

Il ModifyOverflowPolicy metodo configura il comportamento di overflow di un registro eventi. EventLog Istanza. Dopo aver chiamato questo metodo per il registro eventi specificato dalla Log proprietà , i OverflowAction valori della proprietà e MinimumRetentionDays riflettono il comportamento di overflow appena configurato.

Annotazioni

Questa proprietà rappresenta un'impostazione di configurazione per il registro eventi rappresentato da questa istanza. Quando il registro eventi raggiunge le dimensioni massime, questa proprietà specifica il modo in cui il sistema operativo gestisce le nuove voci scritte da tutte le origini eventi registrate per il registro eventi.

Impostare il action parametro su OverwriteAsNeeded per indicare che una nuova voce sovrascrive la voce meno recente quando raggiunge la EventLog dimensione massima. Se il action parametro è impostato su OverwriteAsNeeded, il valore del retentionDays parametro viene ignorato.

Impostare il action parametro su DoNotOverwrite per eliminare nuovi eventi quando viene raggiunta la dimensione massima del log. Se il action parametro è impostato su DoNotOverwrite, il valore del retentionDays parametro viene ignorato.

Avviso

Non impostare mai il action parametro su OverwriteOlder. Questo valore è deprecato e potrebbe causare il comportamento del log come se il DoNotOverwrite parametro fosse passato.

Attenzione

L'impostazione dei criteri di overflow su DoNotOverwrite specifica che le nuove voci vengono rimosse quando il registro eventi è pieno. Se si usa questa impostazione, assicurarsi che il registro eventi sia regolarmente archiviato e cancellato per evitare di raggiungere il limite massimo di dimensioni.

Vedi anche

• OverflowAction
• MaximumKilobytes
• OverflowAction
• MinimumRetentionDays