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.

Комментарии

Этот конструктор инициализирует новый экземпляр StreamWriter класса для указанного файла по указанному пути, используя UTF8 кодировку. Если файл существует, он добавляется в . Если файл не существует, создается новый файл.

Примечание

Чтобы уменьшить вероятность исключения, любой символ, который может сделать вывод недействительным, заменяется символом "?".

Свойство 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 свойство значением name параметра или пустой строкой (""), если name параметр имеет значение null. Имя можно использовать в качестве индекса в Trace.Listeners коллекции для программного изменения свойств прослушивателя. Например, следующий код задает TraceOutputOptions свойство для экземпляра , свойство которого XmlWriterTraceListenerName имеет значение "xmlListener".

((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 свойство значением name параметра или пустой строкой (""), если name параметр имеет значение null. Имя можно использовать в качестве индекса в Trace.Listeners коллекции для программного изменения свойств прослушивателя. Например, следующий код задает TraceOutputOptions свойство для экземпляра , свойство которого XmlWriterTraceListenerName имеет значение "xmlListener".

((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.

Комментарии

Этот конструктор инициализирует новый экземпляр StreamWriter класса для указанного файла по указанному пути, используя UTF8 кодировку. Если файл существует, он добавляется в . Если файл не существует, создается новый файл.

Примечание

Чтобы уменьшить вероятность исключения, любой символ, который может сделать вывод недействительным, заменяется символом "?".

Свойству Namename присваивается значение параметра или пустая строка (""), если name параметр имеет значение null. Имя можно использовать в качестве индекса в Trace.Listeners коллекции для программного изменения свойств прослушивателя. Например, следующий код задает TraceOutputOptions свойство для экземпляра , свойство которого XmlWriterTraceListenerName имеет значение "xmlListener".

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