EventSchemaTraceListener.MaximumNumberOfFiles Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets the maximum number of log files.

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

Public ReadOnly Property MaximumNumberOfFiles As Integer

Property Value

Type: System.Int32

The maximum number of log files, determined by the value of the TraceLogRetentionOption property for the file.

The property value is set by the maximumNumberOfFiles parameter in the constructor or the maximumNumberOfFiles attribute in the configuration file.

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

TraceLogRetentionOption

Maximum number of files

Default number of files

LimitedCircularFiles

N/A

1

LimitedSequentialFiles

N/A

1

SingleFileBoundedSize

N/A

-1

SingleFileUnboundedSize

>0

1

UnlimitedSequentialFiles

>1

2

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

Console.WriteLine("MaximumNumberOfFiles =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).MaximumNumberOfFiles.ToString())

.NET Framework
Available since 3.5
Return to top
Show: