DiskSpaceExhaustedBehavior Property

FileLogTraceListener.DiskSpaceExhaustedBehavior Property

 

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

Namespace:   Microsoft.VisualBasic.Logging
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

public DiskSpaceExhaustedOption DiskSpaceExhaustedBehavior { get; set; }

Property Value

Type: Microsoft.VisualBasic.Logging.DiskSpaceExhaustedOption

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.

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.

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft