This documentation is archived and is not being maintained.

OverflowAction Enumeration

Specifies how to handle entries in an event log that has reached its maximum file size.

Namespace:  System.Diagnostics
Assembly:  System (in System.dll)

public enum OverflowAction

Member nameDescription
DoNotOverwriteIndicates that existing entries are retained when the event log is full and new entries are discarded.
OverwriteAsNeededIndicates that each new entry overwrites the oldest entry when the event log is full.
OverwriteOlderIndicates that new events overwrite events older than specified by the MinimumRetentionDays property value when the event log is full. New events are discarded if the event log is full and there are no events older than specified by the MinimumRetentionDays property value.

Every event log has a maximum size limit and a configurable setting that provides the rule for writing new entries at that limit. When the event log has reached its maximum size, you can specify one of the following rules:

  • New entries will be discarded.

  • New entries will overwrite older entries.

  • New entries will either be discarded or will overwrite existing entries depending upon the age of the existing entries.

Use the ModifyOverflowPolicy method to set the overflow behavior for an EventLog. Check the current configured behavior of an EventLog through its OverflowAction property.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0