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)

Source:

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)

Source:

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)

Source:

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)

Source:

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。

注解

如果namenull参数为 ，name则此构造函数将 属性初始化Name为参数值或空字符串 (“”) 。 该名称可用作集合中的索引， Trace.Listeners 以编程方式更改侦听器的属性。 例如，以下代码为其属性为“xmlListener”的 XmlWriterTraceListenerName 实例设置 TraceOutputOptions 属性。

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

XmlWriterTraceListener(TextWriter, String)

Source:

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。

注解

如果namenull参数为 ，name则此构造函数将 属性初始化Name为参数值或空字符串 (“”) 。 该名称可用作集合中的索引， Trace.Listeners 以编程方式更改侦听器的属性。 例如，以下代码为其属性为“xmlListener”的 XmlWriterTraceListenerName 实例设置 TraceOutputOptions 属性。

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

XmlWriterTraceListener(String, String)

Source:

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。 如果文件存在，则将其追加到 。 如果该文件不存在，则会创建一个新文件。

注意

为了减少发生异常的可能性，任何可能使输出失效的字符都会替换为“？”字符。

如果namenull参数为 ，name则 Name 属性设置为 参数值或空字符串 (“”) 。 该名称可用作集合中的索引， Trace.Listeners 以编程方式更改侦听器的属性。 例如，以下代码为其属性为“xmlListener”的 XmlWriterTraceListenerName 实例设置 TraceOutputOptions 属性。

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