XmlWriterTraceListener 建構函式

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TextWriterTraceListener.dll

初始化 XmlWriterTraceListener 類別的新執行個體。

多載

XmlWriterTraceListener(Stream)	使用指定的資料流做為偵錯和追蹤輸出的接收者，初始化 XmlWriterTraceListener 類別的新執行個體。
XmlWriterTraceListener(TextWriter)	使用指定的寫入器做為偵錯和追蹤輸出的接收者，初始化 XmlWriterTraceListener 類別的新執行個體。
XmlWriterTraceListener(String)	使用指定的檔案做為偵錯和追蹤輸出的接收者，初始化 XmlWriterTraceListener 類別的新執行個體。
XmlWriterTraceListener(Stream, String)	使用指定的資料流做為偵錯和追蹤輸出的接收者，以指定的名稱初始化 XmlWriterTraceListener 類別的新執行個體。
XmlWriterTraceListener(TextWriter, String)	使用指定的寫入器做為偵錯和追蹤輸出的接收者，以指定的名稱初始化 XmlWriterTraceListener 類別的新執行個體。
XmlWriterTraceListener(String, String)	使用指定的檔案做為偵錯和追蹤輸出的接收者，以指定的名稱初始化 XmlWriterTraceListener 類別的新執行個體。

XmlWriterTraceListener(Stream)

來源:

XmlWriterTraceListener.cs

使用指定的資料流做為偵錯和追蹤輸出的接收者，初始化 XmlWriterTraceListener 類別的新執行個體。

public:
 XmlWriterTraceListener(System::IO::Stream ^ stream);

public XmlWriterTraceListener (System.IO.Stream stream);

new System.Diagnostics.XmlWriterTraceListener : System.IO.Stream -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (stream As Stream)

參數

stream

Stream

Stream，表示追蹤接聽程式所寫入的資料流。

例外狀況

ArgumentNullException

stream 為 null。

備註

屬性 Name 會初始化為空字串 (“”) 。

XmlWriterTraceListener(TextWriter)

來源:

XmlWriterTraceListener.cs

使用指定的寫入器做為偵錯和追蹤輸出的接收者，初始化 XmlWriterTraceListener 類別的新執行個體。

public:
 XmlWriterTraceListener(System::IO::TextWriter ^ writer);

public XmlWriterTraceListener (System.IO.TextWriter writer);

new System.Diagnostics.XmlWriterTraceListener : System.IO.TextWriter -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (writer As TextWriter)

參數

writer

TextWriter

TextWriter，從追蹤接聽程式接收輸出。

例外狀況

ArgumentNullException

writer 為 null。

備註

屬性 Name 會初始化為空字串 (“”) 。

XmlWriterTraceListener(String)

來源:

XmlWriterTraceListener.cs

使用指定的檔案做為偵錯和追蹤輸出的接收者，初始化 XmlWriterTraceListener 類別的新執行個體。

public:
 XmlWriterTraceListener(System::String ^ filename);

public XmlWriterTraceListener (string? filename);

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

Public Sub New (filename As String)

參數

filename

String

要寫入的檔案名稱。

例外狀況

ArgumentNullException

filename 為 null。

備註

這個建構函式會使用UTF8編碼，為指定路徑上的指定檔案初始化 類別的新實例StreamWriter。 如果檔案存在，則會附加至 。 如果檔案不存在，則會建立新的檔案。

注意

若要減少例外狀況的機會，可能會使輸出失效的任何字元會取代為 “？” 字元。

屬性 Name 會初始化為空字串 (“”) 。

XmlWriterTraceListener(Stream, String)

來源:

XmlWriterTraceListener.cs

使用指定的資料流做為偵錯和追蹤輸出的接收者，以指定的名稱初始化 XmlWriterTraceListener 類別的新執行個體。

public:
 XmlWriterTraceListener(System::IO::Stream ^ stream, System::String ^ name);

public XmlWriterTraceListener (System.IO.Stream stream, string? name);

new System.Diagnostics.XmlWriterTraceListener : System.IO.Stream * string -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (stream As Stream, name As String)

參數

stream

Stream

Stream，表示追蹤接聽程式所寫入的資料流。

name

String

新執行個體的名稱。

例外狀況

ArgumentNullException

stream 為 null。

備註

如果 name 參數為 null，這個建構函式會將 Name 屬性初始化為name參數值，或初始化為空字串 (“) 。 名稱可作為集合中的 Trace.Listeners 索引，以程式設計方式變更接聽程序的屬性。 例如，下列程式代碼會TraceOutputOptions設定 其 Name 屬性為 「xmlListener」 之 XmlWriterTraceListener 實體的屬性。

((XmlWriterTraceListener)Trace.Listeners["xmlListener"]).TraceOutputOptions =   
    TraceOptions.Timestamp  

XmlWriterTraceListener(TextWriter, String)

來源:

XmlWriterTraceListener.cs

使用指定的寫入器做為偵錯和追蹤輸出的接收者，以指定的名稱初始化 XmlWriterTraceListener 類別的新執行個體。

public:
 XmlWriterTraceListener(System::IO::TextWriter ^ writer, System::String ^ name);

public XmlWriterTraceListener (System.IO.TextWriter writer, string? name);

new System.Diagnostics.XmlWriterTraceListener : System.IO.TextWriter * string -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (writer As TextWriter, name As String)

參數

writer

TextWriter

TextWriter，從追蹤接聽程式接收輸出。

name

String

新執行個體的名稱。

例外狀況

ArgumentNullException

writer 為 null。

備註

如果 name 參數為 null，這個建構函式會將 Name 屬性初始化為name參數值，或初始化為空字串 (“) 。 名稱可作為集合中的 Trace.Listeners 索引，以程式設計方式變更接聽程序的屬性。 例如，下列程式代碼會TraceOutputOptions設定 其 Name 屬性為 「xmlListener」 之 XmlWriterTraceListener 實體的屬性。

((XmlWriterTraceListener)Trace.Listeners["xmlListener"]).TraceOutputOptions =   
    TraceOptions.Timestamp.  

XmlWriterTraceListener(String, String)

來源:

XmlWriterTraceListener.cs

使用指定的檔案做為偵錯和追蹤輸出的接收者，以指定的名稱初始化 XmlWriterTraceListener 類別的新執行個體。

public:
 XmlWriterTraceListener(System::String ^ filename, System::String ^ name);

public XmlWriterTraceListener (string? filename, string? name);

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

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

參數

filename

String

要寫入的檔案名稱。

name

String

新執行個體的名稱。

例外狀況

ArgumentNullException

stream 為 null。

備註

這個建構函式會使用UTF8編碼，為指定路徑上的指定檔案初始化 類別的新實例StreamWriter。 如果檔案存在，則會附加至 。 如果檔案不存在，則會建立新的檔案。

注意

若要減少例外狀況的機會，可能會使輸出失效的任何字元會取代為 “？” 字元。

如果 參數null為 ，屬性Name會設定為name參數值或空字串 (“”“) name。 名稱可作為集合中的 Trace.Listeners 索引，以程式設計方式變更接聽程序的屬性。 例如，下列程式代碼會TraceOutputOptions設定 其 Name 屬性為 「xmlListener」 之 XmlWriterTraceListener 實體的屬性。

((XmlWriterTraceListener)Trace.Listeners["xmlListener"]).TraceOutputOptions =  
    TraceOptions.Timestamp.