TextWriterTraceListener Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Direciona a saída de rastreio ou depuração para um TextWriter ou para um Stream, como FileStream.
public ref class TextWriterTraceListener : System::Diagnostics::TraceListenerpublic class TextWriterTraceListener : System.Diagnostics.TraceListenertype TextWriterTraceListener = class
inherit TraceListenerPublic Class TextWriterTraceListener
Inherits TraceListener- Herança
- Derivado
Exemplos
O exemplo seguinte implementa uma instância da TextWriterTraceListener classe que usa um StreamWriter chamado myOutputWriter para escrever num ficheiro chamado TestFile.txt. Primeiro, o exemplo cria um ficheiro para saída. Depois cria o StreamWriter para o primeiro escritor de texto, atribui-lhe o ficheiro de saída e adiciona-o ao Listenersarquivo . Depois, o código envia uma linha de texto para o ficheiro. Finalmente, o exemplo limpa o buffer de saída.
Depois de executar este exemplo, pode abrir o ficheiro TestFile.txt para ver o resultado.
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
Observações
A TextWriterTraceListener classe fornece a Writer propriedade para obter ou definir o escritor de texto que recebe o resultado de rastreamento ou depuração.
Importante
Este tipo implementa a interface IDisposable. Quando terminar de usar o tipo, você deve eliminá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame seu método Dispose em um bloco try/catch. Para descartá-lo indiretamente, use uma construção de linguagem como using (em C#) ou Using (em Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa IDisposable" no tópico da IDisposable interface.
Esta classe também fornece métodos para Close o Writer para que já não receba saída de rastreamento ou depuração, para Flush o buffer de saída para o Writer, e para Write uma mensagem para o Writer.
Deve ativar o rastreio ou depuração para usar um ouvinte de rastreamento. A sintaxe seguinte é específica do compilador. Se usar compiladores que não sejam C# ou Visual Basic, consulte a documentação do seu compilador.
Para permitir a depuração em C#, adicione a
/d:DEBUGflag à linha de comandos do compilador quando compilar o seu código, ou pode adicionar#define DEBUGno topo do seu ficheiro. Em Visual Basic, adicione a flag/d:DEBUG=Trueà linha de comandos do compilador.Para ativar o traçado em C#, adicione a
/d:TRACEflag à linha de comandos do compilador quando compilar o seu código, ou adicione#define TRACEno topo do seu ficheiro. Em Visual Basic, adicione a flag/d:TRACE=Trueà linha de comandos do compilador.
Para adicionar um ouvinte de traços numa aplicação .NET Framework, edite o ficheiro de configuração correspondente ao nome da sua aplicação. Dentro deste ficheiro, pode adicionar um ouvinte, definir o seu tipo e definir o seu parâmetro, remover um ouvinte ou limpar todos os ouvintes previamente definidos pela aplicação. O ficheiro de configuração deve ser formatado como o seguinte exemplo.
<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>
Note
Se for feita uma tentativa de escrita num ficheiro que está em uso ou indisponível, o nome do ficheiro é automaticamente prefixado por um GUID.
Construtores
| Name | Description |
|---|---|
| TextWriterTraceListener() |
Inicializa uma nova instância da TextWriterTraceListener classe com TextWriter como destinatário de saída. |
| TextWriterTraceListener(Stream, String) |
Inicializa uma nova instância da TextWriterTraceListener classe com o nome especificado, usando o fluxo como destinatário da saída de depuração e rastreamento. |
| TextWriterTraceListener(Stream) |
Inicializa uma nova instância da TextWriterTraceListener classe, usando o fluxo como 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 ficheiro como destinatário da saída de depuração e rastreamento. |
| TextWriterTraceListener(String) |
Inicializa uma nova instância da TextWriterTraceListener classe, usando o ficheiro como 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 escritor especificado como destinatário do resultado de rastreio ou depuração. |
| TextWriterTraceListener(TextWriter) |
Inicializa uma nova instância da TextWriterTraceListener classe usando o escritor especificado como destinatário da saída de rastreio ou depuração. |
Propriedades
| Name | Description |
|---|---|
| Attributes |
Obtém os atributos personalizados do ouvinte de rastreio definidos no ficheiro de configuração da aplicação. (Herdado de TraceListener) |
| Filter |
Obtém ou define o filtro de traço para o ouvinte de traços. (Herdado de TraceListener) |
| IndentLevel |
Obtém ou define o nível da recuação. (Herdado de TraceListener) |
| IndentSize |
Obtém ou define o número de espaços num reentro. (Herdado de TraceListener) |
| IsThreadSafe |
Recebe um valor que indica se o ouvinte de rastreio é seguro para threads. (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 deve indentar a saída. (Herdado de TraceListener) |
| TraceOutputOptions |
Obtém ou define as opções de saída do traço. (Herdado de TraceListener) |
| Writer |
Obtém ou define o escritor de texto que recebe o resultado de rastreio ou depuração. |
Métodos
| Name | Description |
|---|---|
| Close() |
Fecha o Writer para que já não receba saída de rastreamento ou depuração. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Liberta todos os recursos utilizados pelo TraceListener. (Herdado de TraceListener) |
| Dispose(Boolean) |
Elimina este 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 crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Fail(String) |
Emite uma mensagem de erro para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Flush() |
Limpa o buffer de saída para o Writer. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetSupportedAttributes() |
Obtém os atributos personalizados suportados pelo ouvinte de rastreamento. (Herdado de TraceListener) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Escreve informação de traço, um objeto de dados e informações de eventos para a saída específica do ouvinte. (Herdado de TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Escreve informação de rastreio, um array de objetos de dados e informação de eventos para a saída específica do ouvinte. (Herdado de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Escreve informação de rastreio, um array formatado de objetos e informações de eventos para a saída específica do ouvinte. (Herdado de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Escreve informação de rastreio, uma mensagem e informações de eventos para a saída específica do ouvinte. (Herdado de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Escreve informações de rastreio e evento para a saída específica do ouvinte. (Herdado de TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Escreve informação de rastreio, uma mensagem, uma identidade de atividade relacionada e informações de eventos para a saída específica do ouvinte. (Herdado de TraceListener) |
| Write(Object, String) |
Escreve um nome de categoria e o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Write(Object) |
Escreve o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Write(String, String) |
Escreve um nome de categoria e uma mensagem para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Write(String) |
Escreve uma mensagem para o Writer. |
| WriteIndent() |
Escreve o indentamento para o ouvinte que crias quando implementas esta classe, e redefine a NeedIndent propriedade para |
| WriteLine(Object, String) |
Escreve um nome de categoria e o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha. (Herdado de TraceListener) |
| WriteLine(Object) |
Escreve o valor do método do ToString() objeto para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha. (Herdado de TraceListener) |
| WriteLine(String, String) |
Escreve um nome de categoria e uma mensagem para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha. (Herdado de TraceListener) |
| WriteLine(String) |
Escreve uma mensagem nesta instância Writer seguida de um terminador de linha. O terminador de linha por defeito é um retorno de carro seguido de um avanço de linha (\r\n). |