TextWriterTraceListener Classe
Definição
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 de rastreamento ou depuração para um ou para um TextWriterStream, como FileStream.
public ref class TextWriterTraceListener : System::Diagnostics::TraceListenerpublic class TextWriterTraceListener : System.Diagnostics.TraceListenertype TextWriterTraceListener = class
inherit TraceListenerPublic Class TextWriterTraceListener
Inherits TraceListener- Herança
- Herança
- Derivado
Exemplos
O exemplo a seguir implementa uma instância da TextWriterTraceListener classe que usa uma StreamWriter chamada myOutputWriter para gravar em um arquivo chamado TestFile.txt. Primeiro, o exemplo cria um arquivo para saída. Em seguida, ele cria o StreamWriter primeiro gravador de texto, atribui-lhe o arquivo de saída e adiciona-o Listenersao . 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.
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 IDisposable interface. Quando terminar de usar esse tipo ou objeto, você deverá descartá-lo de forma direta ou indireta. 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 (no Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa idisposable" no tópico da IDisposable interface.
Essa classe também fornece métodos para WriterClose que ela não receba mais a saída de rastreamento ou depuração, para Flush o buffer de saída para o .WriteWriterWriter
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:DEBUGsinalizador à linha de comando do compilador ao compilar seu código ou adicione#define DEBUGà parte superior do arquivo. No Visual Basic, adicione o/d:DEBUG=Truesinalizador à linha de comando do compilador.Para habilitar o rastreamento em C#, adicione o
/d:TRACEsinalizador à linha de comando do compilador ao compilar seu código ou adicione#define TRACEà parte superior do arquivo. No Visual Basic, adicione o/d:TRACE=Truesinalizador à 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.
<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>
Observação
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
| Nome | Description |
|---|---|
| TextWriterTraceListener() |
Inicializa uma nova instância da TextWriterTraceListener classe com TextWriter o destinatário de saída. |
| TextWriterTraceListener(Stream, String) |
Inicializa uma nova instância da TextWriterTraceListener classe com o nome especificado, usando o fluxo como o destinatário da saída de depuração e rastreamento. |
| TextWriterTraceListener(Stream) |
Inicializa uma nova instância da TextWriterTraceListener classe, usando o fluxo como o destinatário da saída de depuração e rastreamento. |
| TextWriterTraceListener(String, String) |
Inicializa uma nova instância da TextWriterTraceListener classe com o nome especificado, usando o arquivo como destinatário da saída de depuração e rastreamento. |
| TextWriterTraceListener(String) |
Inicializa uma nova instância da TextWriterTraceListener classe, usando o arquivo como o destinatário da saída de depuração e rastreamento. |
| TextWriterTraceListener(TextWriter, String) |
Inicializa uma nova instância da TextWriterTraceListener classe com o nome especificado, usando o gravador especificado como destinatário da saída de rastreamento ou depuração. |
| TextWriterTraceListener(TextWriter) |
Inicializa uma nova instância da TextWriterTraceListener classe usando o gravador especificado como destinatário da saída de rastreamento ou depuração. |
Propriedades
| Nome | Description |
|---|---|
| Attributes |
Obtém os atributos do ouvinte de rastreamento personalizado definidos no arquivo de configuração do 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 isso TraceListener. (Herdado de TraceListener) |
| NeedIndent |
Obtém ou define um valor que indica se deve recuar a saída. (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 gravador de texto que recebe a saída de rastreamento ou depuração. |
Métodos
| Nome | Description |
|---|---|
| Close() |
Fecha para Writer que ele não receba mais a saída de rastreamento ou depuração. |
| 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 esse TextWriterTraceListener objeto. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Fail(String, String) |
Emite uma mensagem de erro e uma mensagem de erro detalhada para o ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Fail(String) |
Emite uma mensagem de erro para o ouvinte que você cria ao implementar a TraceListener classe. (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 tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| GetSupportedAttributes() |
Obtém os atributos personalizados compatíveis com o 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 dessa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Grava informações de rastreamento, um objeto de dados e informações de evento na 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 para a saída específica do ouvinte. (Herdado de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Grava informações de rastreamento, uma matriz formatada de objetos e informações de 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) |
Grava informações de rastreamento e 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 para a saída específica do ouvinte. (Herdado de TraceListener) |
| Write(Object, String) |
Grava um nome de categoria e o valor do método do ToString() objeto no ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Write(Object) |
Grava o valor do método do ToString() objeto no ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Write(String, String) |
Grava um nome de categoria e uma mensagem no ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Write(String) |
Grava uma mensagem na instância.Writer |
| WriteIndent() |
Grava o recuo no ouvinte que você cria ao implementar essa classe e redefine a NeedIndent propriedade para |
| WriteLine(Object, String) |
Grava um nome de categoria e o valor do método do ToString() objeto no ouvinte que você cria quando implementa a TraceListener classe, seguido por um terminador de linha. (Herdado de TraceListener) |
| WriteLine(Object) |
Grava o valor do método do ToString() objeto no ouvinte que você cria quando implementa a TraceListener classe, seguido por um terminador de linha. (Herdado de TraceListener) |
| WriteLine(String, String) |
Grava um nome de categoria e uma mensagem para o ouvinte que você cria ao implementar a TraceListener classe, seguido por um terminador de linha. (Herdado de TraceListener) |
| WriteLine(String) |
Grava uma mensagem na instância seguida por um terminador de Writer linha. O terminador de linha padrão é um retorno de carro seguido por um feed de linha (\r\n). |
