EventSchemaTraceListener 构造函数

参考

定义

命名空间:: System.Diagnostics

程序集:: System.Core.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

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 不是绝对值;它是一个阈值，最多可以超过最后一条消息的大小。

适用于

通过

EventSchemaTraceListener 构造函数

定义

重载

EventSchemaTraceListener(String)

参数

示例

注解

适用于

EventSchemaTraceListener(String, String)

参数

示例

适用于

EventSchemaTraceListener(String, String, Int32)

参数

示例

注解

适用于

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption)

参数

示例

注解

适用于

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

参数

例外

示例

注解

适用于

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

参数

例外

示例

注解

适用于

其他资源