EventSchemaTraceListener.MaximumFileSize Property

Definition

Gets the maximum size of the log file.

public:
 property long MaximumFileSize { long get(); };
public long MaximumFileSize { get; }
member this.MaximumFileSize : int64
Public ReadOnly Property MaximumFileSize As Long

Property Value

The maximum file size, in bytes.

Examples

The following code example demonstrates how to display the value of the MaximumFileSize property. This code example is part of a larger example that is provided for the EventSchemaTraceListener class.

Console.WriteLine("MaximumFileSize =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).MaximumFileSize);
Console.WriteLine("MaximumFileSize =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).MaximumFileSize.ToString())

Remarks

The property value is set by the maximumFileSize parameter in the constructor or the maximumFileSize attribute in the configuration file. For performance reasons, you should set the maximum file size to a multiple of 1024 bytes. The MaximumFileSize property value is not an absolute; it is a threshold that can be exceeded up to the size of the last message.

The following table shows the possible and default values for file size that are associated with each trace log retention option. The values marked as N/A indicate that the MaximumFileSize property is not checked for that TraceLogRetentionOption value.

TraceLogRetentionOption Maximum file size Default file size
LimitedCircularFiles N/A -1
LimitedSequentialFiles >0 4 KB
SingleFileBoundedSize >0 4 KB
SingleFileUnboundedSize >0 4 KB
UnlimitedSequentialFiles >0 4 KB

Applies to