EventLog.ModifyOverflowPolicy(OverflowAction, Int32) Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.EventLog.dll

Pakiet:

System.Diagnostics.EventLog v8.0.0

Źródło:

EventLog.cs

Zmienia zachowanie skonfigurowane do zapisywania nowych wpisów, gdy dziennik zdarzeń osiągnie maksymalny rozmiar pliku.

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)

Parametry

action

OverflowAction

Zachowanie przepełnienia podczas zapisywania nowych wpisów w dzienniku zdarzeń.

retentionDays

Int32

Minimalna liczba dni przechowywania każdego wpisu dziennika zdarzeń. Ten parametr jest używany tylko wtedy, gdy action jest ustawiony na OverwriteOlderwartość .

Wyjątki

InvalidEnumArgumentException

action jest nieprawidłową OverflowAction wartością.

ArgumentOutOfRangeException

retentionDays wartość jest mniejsza niż jedna lub większa niż 365.

InvalidOperationException

Wartość Log nie jest prawidłową nazwą dziennika.

-lub-

Nie można otworzyć klucza rejestru dziennika zdarzeń na komputerze docelowym.

Przykłady

Poniższy przykład przedstawia skonfigurowane zasady przepełnienia dla określonego dziennika zdarzeń i umożliwia użytkownikowi wybranie nowego ustawienia zasad przepełnienia dla dziennika zdarzeń.

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

Uwagi

Zachowanie przepełnienia dziennika zdarzeń określa, co się stanie, gdy nowe wpisy mają być zapisywane w dzienniku, który osiągnął maksymalny rozmiar pliku.

Uwaga

Zachowanie przepełnienia ma zastosowanie tylko wtedy, gdy dziennik zdarzeń osiągnie maksymalny rozmiar pliku. Zachowanie przepełnienia nie ma wpływu na zapisywanie nowego wpisu w dzienniku, który może pomieścić dodatkowe wpisy dziennika zdarzeń.

Metoda ModifyOverflowPolicy konfiguruje zachowanie przepełnienia dziennika zdarzeń. EventLog Wystąpienie. Po wywołaniu tej metody dla dziennika zdarzeń określonego Log przez właściwość OverflowAction wartości właściwości i MinimumRetentionDays odzwierciedlają nowo skonfigurowane zachowanie przepełnienia.

Uwaga

Ta właściwość reprezentuje ustawienie konfiguracji dziennika zdarzeń reprezentowanego przez to wystąpienie. Gdy dziennik zdarzeń osiągnie maksymalny rozmiar, ta właściwość określa sposób obsługi nowych wpisów zapisywanych przez wszystkie źródła zdarzeń zarejestrowane w dzienniku zdarzeń.

Ustaw parametr , action aby OverwriteAsNeeded wskazać, że nowy wpis zastępuje najstarszy wpis, gdy EventLog osiągnie maksymalny rozmiar. action Jeśli parametr jest ustawiony na OverwriteAsNeededwartość , wartość parametru retentionDays jest ignorowana.

Ustaw parametr , action aby OverwriteOlder wskazać, że każdy nowy wpis zastępuje starsze wpisy, gdy EventLog osiągnie maksymalny rozmiar. Określ liczbę dni przechowywania zdarzeń w dzienniku przy użyciu parametru retentionDays . Zdarzenia zapisane w zakresie przechowywania nie są zastępowane przez nowe wpisy.

Ustaw parametr na wartość , action aby DoNotOverwrite odrzucić nowe zdarzenia po osiągnięciu maksymalnego rozmiaru dziennika. action Jeśli parametr jest ustawiony na DoNotOverwritewartość , wartość parametru retentionDays jest ignorowana.

Przestroga

Ustawienie zasad przepełnienia w celu DoNotOverwrite określenia, że nowe wpisy są odrzucane, gdy dziennik zdarzeń jest pełny. Jeśli używasz tego ustawienia, upewnij się, że dziennik zdarzeń jest regularnie archiwizowany i czyszczone, aby uniknąć osiągnięcia maksymalnego limitu rozmiaru.

Zobacz też

• OverflowAction
• MaximumKilobytes
• OverflowAction
• MinimumRetentionDays