TextWriterTraceListener Classe

Referência

Definição

Namespace:: System.Diagnostics

Assembly:: System.Diagnostics.TextWriterTraceListener.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origem:: TextWriterTraceListener.cs

Origem:: TextWriterTraceListener.cs

Origem:: TextWriterTraceListener.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Direciona a saída do rastreamento ou da depuração para um TextWriter ou um Stream, como FileStream.

public ref class TextWriterTraceListener : System::Diagnostics::TraceListener

public class TextWriterTraceListener : System.Diagnostics.TraceListener

type TextWriterTraceListener = class
    inherit TraceListener

Public Class TextWriterTraceListener
Inherits TraceListener

Herança: Object

MarshalByRefObject

TraceListener
TextWriterTraceListener

Herança: Object

TraceListener
TextWriterTraceListener

Derivado: System.Diagnostics.ConsoleTraceListener

System.Diagnostics.DelimitedListTraceListener

System.Diagnostics.EventSchemaTraceListener

System.Diagnostics.XmlWriterTraceListener

Exemplos

O exemplo a seguir implementa uma instância da TextWriterTraceListener classe que usa um StreamWriter chamado myOutputWriter para gravar em um arquivo chamado TestFile.txt. Primeiro, o exemplo cria um arquivo para saída. Em seguida, ele cria o StreamWriter para o primeiro gravador de texto, atribui-lhe o arquivo de saída e adiciona-o ao Listeners. Em seguida, o código gera uma linha de texto para o arquivo. Por fim, o exemplo libera o buffer de saída.

Depois de executar este exemplo, você pode abrir o TestFile.txt arquivo para ver a saída.

void main()
{
   #if defined(TRACE)
   // Create a file for output named TestFile.txt.
   Stream^ myFile = File::Create( "TestFile.txt" );
   
   // Create a new text writer using the output stream and
   // add it to the trace listeners.
   TextWriterTraceListener^ myTextListener = 
      gcnew TextWriterTraceListener( myFile );
   Trace::Listeners->Add( myTextListener );
  
   // Write output to the file.
   Trace::Write( "Test output " );
  
   // Flush the output.
   Trace::Flush();
   Trace::Close();
   #endif
}

public class Sample
{

public static int Main(string[] args) {
    // Create a file for output named TestFile.txt.
    Stream myFile = File.Create("TestFile.txt");

    /* Create a new text writer using the output stream, and add it to
     * the trace listeners. */
    TextWriterTraceListener myTextListener = new
       TextWriterTraceListener(myFile);
    Trace.Listeners.Add(myTextListener);

    // Write output to the file.
    Trace.Write("Test output ");

    // Flush the output.
    Trace.Flush();

    return 0;
 }
}

Public Class Sample
    
    Public Shared Sub Main()
        ' Create a file for output named TestFile.txt.
        Dim myFile As Stream = File.Create("TestFile.txt")
        
        ' Create a new text writer using the output stream, and add it to
        ' the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myFile)
        Trace.Listeners.Add(myTextListener)

        
        ' Write output to the file.
        Trace.Write("Test output ")
        
        ' Flush the output.
        Trace.Flush() 

        System.Environment.ExitCode = 0
    End Sub

End Class

Comentários

A TextWriterTraceListener classe fornece a Writer propriedade para obter ou definir o gravador de texto que recebe a saída de rastreamento ou depuração.

Importante

Esse tipo implementa a interface IDisposable. Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch. Para descartá-lo indiretamente, use um constructo de linguagem como using ( em C#) ou Using (em Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.

Essa classe também fornece métodos para o para que ele não receba mais a saída de rastreamento ou depuração, para Flush o buffer de saída para o Writere para Write uma mensagem para o Writer.Close Writer

Você deve habilitar o rastreamento ou a depuração para usar um ouvinte de rastreamento. A sintaxe a seguir é específica do compilador. Se você usar compiladores diferentes de C# ou Visual Basic, consulte a documentação do compilador.

Para habilitar a depuração em C#, adicione o /d:DEBUG sinalizador à linha de comando do compilador ao compilar o código ou adicione #define DEBUG à parte superior do arquivo. No Visual Basic, adicione o /d:DEBUG=True sinalizador à linha de comando do compilador.
Para habilitar o rastreamento em C#, adicione o /d:TRACE sinalizador à linha de comando do compilador ao compilar o código ou adicione #define TRACE à parte superior do arquivo. No Visual Basic, adicione o /d:TRACE=True sinalizador à linha de comando do compilador.

Para adicionar um ouvinte de rastreamento em um aplicativo .NET Framework, edite o arquivo de configuração que corresponde ao nome do aplicativo. Nesse arquivo, você pode adicionar um ouvinte, definir seu tipo e definir seu parâmetro, remover um ouvinte ou limpar todos os ouvintes definidos anteriormente pelo aplicativo. O arquivo de configuração deve ser formatado como o exemplo a seguir.

XML

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener"   
          type="System.Diagnostics.TextWriterTraceListener"   
          initializeData="TextWriterOutput.log" />  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

Nota

Se for feita uma tentativa de gravar em um arquivo que esteja em uso ou indisponível, o nome do arquivo será automaticamente prefixado por um GUID.

Construtores

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

Propriedades

Attributes	Obtém os atributos do ouvinte de rastreamento personalizados definidos no arquivo de configuração de aplicativo. (Herdado de TraceListener)
Filter	Obtém ou define o filtro de rastreamento para o ouvinte de rastreamento. (Herdado de TraceListener)
IndentLevel	Obtém ou define o nível de recuo. (Herdado de TraceListener)
IndentSize	Obtém ou define o número de espaços em um recuo. (Herdado de TraceListener)
IsThreadSafe	Obtém um valor que indica se o ouvinte de rastreamento é thread-safe. (Herdado de TraceListener)
Name	Obtém ou define um nome para este TraceListener. (Herdado de TraceListener)
NeedIndent	Obtém ou define um valor que indica se a saída deve ser recuada. (Herdado de TraceListener)
TraceOutputOptions	Obtém ou define as opções de saída de rastreamento. (Herdado de TraceListener)
Writer	Obtém ou define o text writer que recebe a saída do rastreamento ou da depuração.

Métodos

Close()	Fecha o Writer para que ele não receba mais a saída de rastreamento ou de depuração.
Close()	Quando substituído em uma classe derivada, fecha o fluxo de saída para que ele não receba mais saídas de rastreamento ou depuração. (Herdado de TraceListener)
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo TraceListener. (Herdado de TraceListener)
Dispose(Boolean)	Descarta este objeto TextWriterTraceListener.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Fail(String)	Emite uma mensagem de erro para o ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Fail(String, String)	Emite uma mensagem de erro e uma mensagem de erro detalhada para o ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Flush()	Libera o buffer de saída para o Writer.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetSupportedAttributes()	Obtém os atributos personalizados com suporte no ouvinte de rastreamento. (Herdado de TraceListener)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Grava as informações de rastreamento, um objeto de dados e informações de evento para a saída específica do ouvinte. (Herdado de TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Grava informações de rastreamento, uma matriz de objetos de dados e informações de evento na saída específica do ouvinte. (Herdado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Grava as informações de rastreamento e evento para a saída específica do ouvinte. (Herdado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Grava informações de rastreamento, uma mensagem e informações de evento na saída específica do ouvinte. (Herdado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Grava informações de rastreamento, uma matriz de objetos formatada e informações de evento na saída específica do ouvinte. (Herdado de TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Grava informações de rastreamento, uma mensagem, uma identidade de atividade relacionada e informações de evento na saída específica do ouvinte. (Herdado de TraceListener)
Write(Object)	Grava o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Write(Object, String)	Grava um nome de categoria e o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Write(String)	Grava uma mensagem no Writer desta instância.
Write(String, String)	Grava um nome de categoria e uma mensagem no ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
WriteIndent()	Grava o recuo para o ouvinte criar durante a implementação dessa classe e redefine a propriedade NeedIndent para `false`. (Herdado de TraceListener)
WriteLine(Object)	Grava o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha. (Herdado de TraceListener)
WriteLine(Object, String)	Grava um nome de categoria e o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha. (Herdado de TraceListener)
WriteLine(String)	Grava uma mensagem no Writer desta instância seguido por um terminador de linha. O terminador de linha padrão é um retorno de carro seguido por uma alimentação de linha (\r\n).
WriteLine(String, String)	Grava um nome de categoria e uma mensagem no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha. (Herdado de TraceListener)

Aplica-se a

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Partilhar via