FileLogTraceListener::Append Property

.NET Framework (current version)
 

Determines whether to append the output to the current file or write it to a new file.

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

C#
C++
F#
VB
Copy 
public:
property bool Append {
	bool get();
	void set(bool value);
}

Property Value

Type: System::Boolean

Boolean, with True indicating that the output is appended to the current file, and False indicating that output is written to a new file. The default setting for this property is True.

When the Append property is False, the output is written to a new file. When the property is True, the output is appended to the current file, unless:

  • The output file is locked by another process. In this situation, a new log file is created with a version number that is incorporated into the FullLogFileName name.

  • The current file size is greater than what the MaxFileSize property allows. In this situation, additional messages are discarded and, depending on the DiskSpaceExhaustedBehavior property, an exception is thrown.

  • The existing file name is out of date according to the log-creation schedule specified by the LogFileCreationSchedule property. In this situation, a new log file is created and the date stamp is incorporated into the FullLogFileName name.

.NET Framework
Available since 2.0
Return to top
Show: