EventLog.ModifyOverflowPolicy(OverflowAction, Int32) Methode

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

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

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.ModifyOverflowPolicy : System.Diagnostics.OverflowAction * int -> unit

Public Sub ModifyOverflowPolicy (action As OverflowAction, retentionDays As Integer)

Parameter

Attribute

ComVisibleAttribute

Ausnahmen

Beispiele

Im folgenden Beispiel wird die konfigurierte Überlaufrichtlinie für ein angegebenes Ereignisprotokoll angezeigt, und der Benutzer kann eine neue Überlaufrichtlinieneinstellung für das Ereignisprotokoll auswählen.

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

Hinweise

Das Überlaufverhalten für ein Ereignisprotokoll gibt an, was passiert, wenn neue Einträge in ein Protokoll geschrieben werden sollen, das seine maximale Dateigröße erreicht hat.

Die ModifyOverflowPolicy Methode konfiguriert das Überlaufverhalten eines Ereignisprotokolls. EventLog Instanz. Nachdem Sie diese Methode für das durch die Log Eigenschaft angegebene Ereignisprotokoll aufgerufen haben, spiegeln die OverflowAction Werte und MinimumRetentionDays Eigenschaften das neu konfigurierte Überlaufverhalten wider.

Legen Sie den action Parameter fest, um OverwriteAsNeeded anzugeben, dass ein neuer Eintrag den ältesten Eintrag überschreibt, wenn die EventLog maximale Größe erreicht ist. Wenn der action Parameter auf OverwriteAsNeeded festgelegt ist, wird der retentionDays Parameterwert ignoriert.

Legen Sie den action Parameter fest, um neue Ereignisse zu DoNotOverwrite verwerfen, wenn die maximale Protokollgröße erreicht ist. Wenn der action Parameter auf DoNotOverwrite festgelegt ist, wird der retentionDays Parameterwert ignoriert.

Weitere Informationen

• OverflowAction
• MaximumKilobytes
• OverflowAction
• MinimumRetentionDays