FileLogTraceListener.DiskSpaceExhaustedBehavior Property

Definition

Determines what to do when writing to the log file and there is less free disk space available than specified by the ReserveDiskSpace property.

public:
 property Microsoft::VisualBasic::Logging::DiskSpaceExhaustedOption DiskSpaceExhaustedBehavior { Microsoft::VisualBasic::Logging::DiskSpaceExhaustedOption get(); void set(Microsoft::VisualBasic::Logging::DiskSpaceExhaustedOption value); };
public Microsoft.VisualBasic.Logging.DiskSpaceExhaustedOption DiskSpaceExhaustedBehavior { get; set; }
member this.DiskSpaceExhaustedBehavior : Microsoft.VisualBasic.Logging.DiskSpaceExhaustedOption with get, set
Public Property DiskSpaceExhaustedBehavior As DiskSpaceExhaustedOption

Property Value

DiskSpaceExhaustedOption. Determines what to do when attempting to write to the log file and there is less free disk space available than specified by the ReserveDiskSpace property, or if the log file size is greater than what the MaxFileSize property allows. The default value is DiscardMessages.

Remarks

When the DiskSpaceExhaustedBehavior property is set to DiscardMessages, the log messages are silently discarded if there is not enough reserved disk space. This is the default behavior, and it prevents simple applications from failing if the disk gets too full.

More robust applications can set the DiskSpaceExhaustedBehavior property to ThrowException, and add Try...Catch blocks around all code that writes to the log.

Applies to

See also