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 不是絕對值;這是可超過最後一則訊息大小的臨界值。