XmlWriterTraceListener Construtores

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TextWriterTraceListener.dll

Inicializa uma nova instância da classe XmlWriterTraceListener.

Sobrecargas

XmlWriterTraceListener(Stream)	Inicializa uma nova instância da classe XmlWriterTraceListener, usando o fluxo especificado como o destinatário da saída de depuração e de rastreamento.
XmlWriterTraceListener(TextWriter)	Inicializa uma nova instância da classe XmlWriterTraceListener usando o gravador especificado como o destinatário da saída de depuração e de rastreamento.
XmlWriterTraceListener(String)	Inicializa uma nova instância da classe XmlWriterTraceListener usando o arquivo especificado como o destinatário da saída de depuração e de rastreamento.
XmlWriterTraceListener(Stream, String)	Inicializa uma nova instância da classe XmlWriterTraceListener com o nome especificado, usando o fluxo especificado como o destinatário da saída de depuração e de rastreamento.
XmlWriterTraceListener(TextWriter, String)	Inicializa uma nova instância da classe XmlWriterTraceListener com o nome especificado, usando o gravador especificado como o destinatário da saída de depuração e de rastreamento.
XmlWriterTraceListener(String, String)	Inicializa uma nova instância da classe XmlWriterTraceListener com o nome especificado, usando o arquivo especificado como o destinatário da saída de depuração e de rastreamento.

XmlWriterTraceListener(Stream)

Origem:

XmlWriterTraceListener.cs

Inicializa uma nova instância da classe XmlWriterTraceListener, usando o fluxo especificado como o destinatário da saída de depuração e de rastreamento.

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)

Parâmetros

stream

Stream

Um Stream que representa o fluxo no qual o ouvinte de rastreamento grava.

Exceções

ArgumentNullException

stream é null.

Comentários

A Name propriedade é inicializada para uma cadeia de caracteres vazia ("").

XmlWriterTraceListener(TextWriter)

Origem:

XmlWriterTraceListener.cs

Inicializa uma nova instância da classe XmlWriterTraceListener usando o gravador especificado como o destinatário da saída de depuração e de rastreamento.

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)

Parâmetros

writer

TextWriter

Um TextWriter que recebe a saída do ouvinte de rastreamento.

Exceções

ArgumentNullException

writer é null.

Comentários

A Name propriedade é inicializada para uma cadeia de caracteres vazia ("").

XmlWriterTraceListener(String)

Origem:

XmlWriterTraceListener.cs

Inicializa uma nova instância da classe XmlWriterTraceListener usando o arquivo especificado como o destinatário da saída de depuração e de rastreamento.

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

public XmlWriterTraceListener (string? filename);

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

Public Sub New (filename As String)

Parâmetros

filename

String

O nome do arquivo no qual gravar.

Exceções

ArgumentNullException

filename é null.

Comentários

Esse construtor inicializa uma nova instância da StreamWriter classe para o arquivo especificado no caminho especificado, usando UTF8 codificação. Se o arquivo existir, ele será acrescentado a. Se o arquivo não existir, um novo arquivo será criado.

Observação

Para reduzir a chance de uma exceção, qualquer caractere que possa invalidar a saída é substituído por um caractere "?".

A Name propriedade é inicializada para uma cadeia de caracteres vazia ("").

XmlWriterTraceListener(Stream, String)

Origem:

XmlWriterTraceListener.cs

Inicializa uma nova instância da classe XmlWriterTraceListener com o nome especificado, usando o fluxo especificado como o destinatário da saída de depuração e de rastreamento.

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)

Parâmetros

stream

Stream

Um Stream que representa o fluxo no qual o ouvinte de rastreamento grava.

name

String

O nome da nova instância.

Exceções

ArgumentNullException

stream é null.

Comentários

Esse construtor inicializa a Name propriedade para o valor do name parâmetro ou para uma cadeia de caracteres vazia ("") se o name parâmetro for null. O nome pode ser usado como um índice na Trace.Listeners coleção para alterar programaticamente as propriedades do ouvinte. Por exemplo, o código a seguir define a TraceOutputOptions propriedade para uma instância de XmlWriterTraceListener cuja Name propriedade é "xmlListener".

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

XmlWriterTraceListener(TextWriter, String)

Origem:

XmlWriterTraceListener.cs

Inicializa uma nova instância da classe XmlWriterTraceListener com o nome especificado, usando o gravador especificado como o destinatário da saída de depuração e de rastreamento.

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)

Parâmetros

writer

TextWriter

Um TextWriter que recebe a saída do ouvinte de rastreamento.

name

String

O nome da nova instância.

Exceções

ArgumentNullException

writer é null.

Comentários

Esse construtor inicializa a Name propriedade para o valor do name parâmetro ou para uma cadeia de caracteres vazia ("") se o name parâmetro for null. O nome pode ser usado como um índice na Trace.Listeners coleção para alterar programaticamente as propriedades do ouvinte. Por exemplo, o código a seguir define a TraceOutputOptions propriedade para uma instância de XmlWriterTraceListener cuja Name propriedade é "xmlListener".

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

XmlWriterTraceListener(String, String)

Origem:

XmlWriterTraceListener.cs

Inicializa uma nova instância da classe XmlWriterTraceListener com o nome especificado, usando o arquivo especificado como o destinatário da saída de depuração e de rastreamento.

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)

Parâmetros

filename

String

O nome do arquivo no qual gravar.

name

String

O nome da nova instância.

Exceções

ArgumentNullException

stream é null.

Comentários

Esse construtor inicializa uma nova instância da StreamWriter classe para o arquivo especificado no caminho especificado, usando UTF8 codificação. Se o arquivo existir, ele será acrescentado a. Se o arquivo não existir, um novo arquivo será criado.

Observação

Para reduzir a chance de uma exceção, qualquer caractere que possa invalidar a saída é substituído por um caractere "?".

A Name propriedade será definida como o valor do name parâmetro ou como uma cadeia de caracteres vazia ("") se o name parâmetro for null. O nome pode ser usado como um índice na Trace.Listeners coleção para alterar programaticamente as propriedades do ouvinte. Por exemplo, o código a seguir define a TraceOutputOptions propriedade para uma instância de XmlWriterTraceListener cuja Name propriedade é "xmlListener".

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