EventLog.ModifyOverflowPolicy(OverflowAction, Int32) Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.EventLog.dll

Kaynak:

EventLog.cs

Olay günlüğü dosya boyutu üst sınırına ulaştığında yeni girdiler yazmak için yapılandırılmış davranışı değiştirir.

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)

Parametreler

action

OverflowAction

Olay günlüğüne yeni girdiler yazmak için taşma davranışı. olmamalıdır OverwriteOlder.

retentionDays

Int32

Deprecated. 0 olmalıdır.

Özel durumlar

InvalidEnumArgumentException

action geçerli OverflowAction bir değer değil.

ArgumentOutOfRangeException

retentionDays birden az veya 365'ten büyük.

InvalidOperationException

Değer Log geçerli bir günlük adı değil.

-veya-

Olay günlüğünün kayıt defteri anahtarı hedef bilgisayarda açılamadı.

Örnekler

Aşağıdaki örnek, belirtilen olay günlüğü için yapılandırılmış taşma ilkesini görüntüler ve kullanıcının olay günlüğü için yeni bir taşma ilkesi ayarı seçmesine izin verir.

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

Açıklamalar

Bir olay günlüğünün taşma davranışı, en büyük dosya boyutuna ulaşmış bir günlüğe yeni girdiler yazıldığında ne olacağını belirtir.

Uyarı

Taşma davranışı yalnızca bir olay günlüğü dosya boyutu üst sınırına ulaştığında geçerlilik kazanır. Taşma davranışı, ek olay günlüğü girişlerini barındırabilecek bir günlüğe yeni giriş yazmayı etkilemez.

yöntemi, ModifyOverflowPolicy bir olay günlüğünün taşma davranışını yapılandırıyor. EventLog Örnek. özelliği OverflowAction tarafından Log belirtilen olay günlüğü için bu yöntemi çağırdıktan sonra ve MinimumRetentionDays özellik değerleri yeni yapılandırılan taşma davranışını yansıtır.

Uyarı

Bu özellik, bu örnek tarafından temsil edilen olay günlüğü için bir yapılandırma ayarını temsil eder. Olay günlüğü boyut üst sınırına ulaştığında, bu özellik işletim sisteminin olay günlüğü için kaydedilen tüm olay kaynakları tarafından yazılan yeni girişleri nasıl işlediğini belirtir.

parametresini action , OverwriteAsNeeded yeni bir girdinin en büyük boyutuna ulaştığında en eski girdinin EventLog üzerine yazdığını belirtmek için olarak ayarlayın. action parametresi olarak ayarlanırsaOverwriteAsNeededretentionDays, parametre değeri yoksayılır.

En büyük günlük boyutuna action ulaşıldığında yeni olayları atmak için parametresini DoNotOverwrite olarak ayarlayın. action parametresi olarak ayarlanırsaDoNotOverwriteretentionDays, parametre değeri yoksayılır.

Uyarı

Parametresini hiçbir zaman olarak ayarlamayın actionOverwriteOlder. Bu değer kullanım dışıdır ve günlüğün bunun yerine parametre geçirilmiş gibi davranmasına DoNotOverwrite neden olabilir.

Dikkat

Taşma ilkesinin, olay günlüğü dolduğunda yeni girdilerin atıldığını belirtecek DoNotOverwrite şekilde ayarlanması. Bu ayarı kullanırsanız, boyut üst sınırına ulaşmamak için olay günlüğünün düzenli olarak arşivlendiğinden ve temizlendiğinden emin olun.

Ayrıca bkz.

• OverflowAction
• MaximumKilobytes
• OverflowAction
• MinimumRetentionDays