EventSchemaTraceListener 构造函数

定义

命名空间:

System.Diagnostics

程序集:

System.Core.dll

初始化 EventSchemaTraceListener 类的新实例。

重载

EventSchemaTraceListener(String)	通过将指定文件用作调试和跟踪输出的接收方来初始化 EventSchemaTraceListener 类的新实例。
EventSchemaTraceListener(String, String)	通过将指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称的 EventSchemaTraceListener 类的新实例。
EventSchemaTraceListener(String, String, Int32)	通过将指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称和指定缓冲区大小的 EventSchemaTraceListener 类的新实例。
EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption)	通过将具有指定日志保留策略的指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称和指定缓冲区大小的 EventSchemaTraceListener 类的新实例。
EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64)	通过将具有指定日志保留策略和最大大小的指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称和缓冲区大小的 EventSchemaTraceListener 类的新实例。
EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32)	通过将具有指定日志保留策略、最大大小和文件计数的指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称和指定缓冲区大小的 EventSchemaTraceListener 类的新实例。

EventSchemaTraceListener(String)

通过将指定文件用作调试和跟踪输出的接收方来初始化 EventSchemaTraceListener 类的新实例。

public:
 EventSchemaTraceListener(System::String ^ fileName);

public EventSchemaTraceListener (string fileName);

new System.Diagnostics.EventSchemaTraceListener : string -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String)

参数

fileName

String

日志文件的路径。

示例

下面的代码示例演示如何使用 EventSchemaTraceListener.EventSchemaTraceListener(String) 构造函数。

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml"));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml"))

注解

默认情况下，记录一个不受限制大小的文件。

EventSchemaTraceListener(String, String)

通过将指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称的 EventSchemaTraceListener 类的新实例。

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name);

public EventSchemaTraceListener (string fileName, string name);

new System.Diagnostics.EventSchemaTraceListener : string * string -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String, name As String)

参数

fileName

String

日志文件的路径。

name

String

侦听器名称。

示例

下面的代码示例演示如何使用 EventSchemaTraceListener.EventSchemaTraceListener(String, String, Int32) 构造函数。

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener"));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener"))

EventSchemaTraceListener(String, String, Int32)

通过将指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称和指定缓冲区大小的 EventSchemaTraceListener 类的新实例。

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name, int bufferSize);

public EventSchemaTraceListener (string fileName, string name, int bufferSize);

new System.Diagnostics.EventSchemaTraceListener : string * string * int -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String, name As String, bufferSize As Integer)

参数

fileName

String

日志文件的路径。

name

String

侦听器名称。

bufferSize

Int32

输出缓冲区的大小（以字节为单位）。

示例

下面的代码示例演示如何使用 EventSchemaTraceListener.EventSchemaTraceListener(String, String, Int32) 构造函数。

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536))

注解

出于性能考虑， bufferSize 应是 1024 字节的倍数。

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption)

通过将具有指定日志保留策略的指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称和指定缓冲区大小的 EventSchemaTraceListener 类的新实例。

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name, int bufferSize, System::Diagnostics::TraceLogRetentionOption logRetentionOption);

public EventSchemaTraceListener (string fileName, string name, int bufferSize, System.Diagnostics.TraceLogRetentionOption logRetentionOption);

new System.Diagnostics.EventSchemaTraceListener : string * string * int * System.Diagnostics.TraceLogRetentionOption -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String, name As String, bufferSize As Integer, logRetentionOption As TraceLogRetentionOption)

参数

fileName

String

日志文件的路径。

name

String

侦听器名称。

bufferSize

Int32

输出缓冲区的大小（以字节为单位）。

logRetentionOption

TraceLogRetentionOption

TraceLogRetentionOption 值之一。

示例

下面的代码示例演示如何使用 EventSchemaTraceListener.EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption) 构造函数。

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles))

注解

出于性能考虑， bufferSize 应是 1024 字节的倍数。

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64)

通过将具有指定日志保留策略和最大大小的指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称和缓冲区大小的 EventSchemaTraceListener 类的新实例。

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name, int bufferSize, System::Diagnostics::TraceLogRetentionOption logRetentionOption, long maximumFileSize);

public EventSchemaTraceListener (string fileName, string name, int bufferSize, System.Diagnostics.TraceLogRetentionOption logRetentionOption, long maximumFileSize);

new System.Diagnostics.EventSchemaTraceListener : string * string * int * System.Diagnostics.TraceLogRetentionOption * int64 -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String, name As String, bufferSize As Integer, logRetentionOption As TraceLogRetentionOption, maximumFileSize As Long)

参数

fileName

String

日志文件的路径。

name

String

侦听器名称。

bufferSize

Int32

输出缓冲区的大小（以字节为单位）。

logRetentionOption

TraceLogRetentionOption

TraceLogRetentionOption 值之一。

maximumFileSize

Int64

最大文件大小（以字节为单位）。

例外

ArgumentOutOfRangeException

maximumFileSize 为负数或小于 bufferSize。

- 或 -

bufferSize 为负数。

示例

下面的代码示例演示如何使用 EventSchemaTraceListener.EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64) 构造函数。

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000))

注解

出于性能考虑， bufferSize 和 maximumFileSize 应为 1024 字节的倍数。 maximumFileSize 不是绝对值，它是一个阈值，最大可能超过最后一条消息的大小。

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32)

通过将具有指定日志保留策略、最大大小和文件计数的指定文件用作调试和跟踪输出的接收方，来初始化具有指定名称和指定缓冲区大小的 EventSchemaTraceListener 类的新实例。

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name, int bufferSize, System::Diagnostics::TraceLogRetentionOption logRetentionOption, long maximumFileSize, int maximumNumberOfFiles);

public EventSchemaTraceListener (string fileName, string name, int bufferSize, System.Diagnostics.TraceLogRetentionOption logRetentionOption, long maximumFileSize, int maximumNumberOfFiles);

new System.Diagnostics.EventSchemaTraceListener : string * string * int * System.Diagnostics.TraceLogRetentionOption * int64 * int -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String, name As String, bufferSize As Integer, logRetentionOption As TraceLogRetentionOption, maximumFileSize As Long, maximumNumberOfFiles As Integer)

参数

fileName

String

日志文件的路径。

name

String

侦听器名称。

bufferSize

Int32

输出缓冲区的大小（以字节为单位）。

logRetentionOption

TraceLogRetentionOption

TraceLogRetentionOption 值之一。

maximumFileSize

Int64

最大文件大小（以字节为单位）。

maximumNumberOfFiles

Int32

输出日志文件的最大数。

例外

ArgumentOutOfRangeException

maximumFileSize 为负数或小于 bufferSize。

- 或 -

maximumNumberOfFiles 小于 1，且 logRetentionOption 为 LimitedSequentialFiles。

- 或 -

maximumNumberOfFiles 小于 2，logRetentionOption 为 LimitedCircularFiles。

- 或 -

bufferSize 为负数。

示例

下面的代码示例演示如何使用 EventSchemaTraceListener 构造函数。 此代码示例是为 EventSchemaTraceListener 类提供的一个更大示例的一部分。

//ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000, 2));
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener"));

ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000, 2))

注解

出于性能考虑， bufferSize 和 maximumFileSize 应为 1024 字节的倍数。 maximumFileSize 不是绝对值;它是一个阈值，最多可以超过最后一条消息的大小。