使用英语阅读

通过

EventLog.OverflowAction 属性

  • 参考

定义

命名空间:
System.Diagnostics
程序集:
System.Diagnostics.EventLog.dll
程序集:
System.dll
包:
System.Diagnostics.EventLog v6.0.0
包:
System.Diagnostics.EventLog v7.0.0
包:
System.Diagnostics.EventLog v8.0.0
包:
System.Diagnostics.EventLog v9.0.0-preview.2.24128.5
Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

获取已配置的行为，以便在事件日志达到其最大文件大小时存储新项。

[System.ComponentModel.Browsable(false)]
public System.Diagnostics.OverflowAction OverflowAction { get; }
[System.ComponentModel.Browsable(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public System.Diagnostics.OverflowAction OverflowAction { get; }

属性值

OverflowAction

OverflowAction 值，指定在事件日志达到其最大日志大小时存储新项的已配置行为。 默认值为 OverwriteOlder。

属性
BrowsableAttribute ComVisibleAttribute

示例

以下示例枚举在本地计算机上定义的事件日志，并显示每个事件日志的配置详细信息。

static void DisplayEventLogProperties()
{
    // Iterate through the current set of event log files,
    // displaying the property settings for each file.

    EventLog[] eventLogs = EventLog.GetEventLogs();
    foreach (EventLog e in eventLogs)
    {
        Int64 sizeKB = 0;

        Console.WriteLine();
        Console.WriteLine("{0}:", e.LogDisplayName);
        Console.WriteLine("  Log name = \t\t {0}", e.Log);

        Console.WriteLine("  Number of event log entries = {0}", e.Entries.Count.ToString());

        // Determine if there is an event log file for this event log.
        RegistryKey regEventLog = Registry.LocalMachine.OpenSubKey("System\\CurrentControlSet\\Services\\EventLog\\" + e.Log);
        if (regEventLog != null)
        {
            Object temp = regEventLog.GetValue("File");
            if (temp != null)
            {
                Console.WriteLine("  Log file path = \t {0}", temp.ToString());
                FileInfo file = new FileInfo(temp.ToString());

                // Get the current size of the event log file.
                if (file.Exists)
                {
                    sizeKB = file.Length / 1024;
                    if ((file.Length % 1024) != 0)
                    {
                        sizeKB++;
                    }
                    Console.WriteLine("  Current size = \t {0} kilobytes", sizeKB.ToString());
                }
            }
            else
            {
                Console.WriteLine("  Log file path = \t <not set>");
            }
        }

        // Display the maximum size and overflow settings.

        sizeKB = e.MaximumKilobytes;
        Console.WriteLine("  Maximum size = \t {0} kilobytes", sizeKB.ToString());
        Console.WriteLine("  Overflow setting = \t {0}", e.OverflowAction.ToString());

        switch (e.OverflowAction)
        {
            case OverflowAction.OverwriteOlder:
                Console.WriteLine("\t Entries are retained a minimum of {0} days.",
                    e.MinimumRetentionDays);
                break;
            case OverflowAction.DoNotOverwrite:
                Console.WriteLine("\t Older entries are not overwritten.");
                break;
            case OverflowAction.OverwriteAsNeeded:
                Console.WriteLine("\t If number of entries equals max size limit, a new event log entry overwrites the oldest entry.");
                break;
            default:
                break;
        }
    }
}

注解

事件日志的大小随着新事件的写入而增加。 每个事件日志都有配置的最大大小限制; MaximumKilobytes 属性定义事件日志文件大小允许的最大千字节数。

OverflowAction使用 属性值检查事件日志最大大小的已配置溢出行为。 ModifyOverflowPolicy使用 方法更改事件日志的溢出行为。

备注

仅当事件日志达到其最大文件大小时，溢出行为才会生效。 溢出行为不会影响将新条目写入可以容纳其他事件日志条目的日志。

适用于

产品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

另请参阅