DelimitedListTraceListener 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 o rastreio ou a saída de depuração para um gravador de texto, como um gravador de fluxo, ou para um fluxo, como um fluxo de ficheiro.
public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListenerpublic class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListenertype DelimitedListTraceListener = class
inherit TextWriterTraceListenerPublic Class DelimitedListTraceListener
Inherits TextWriterTraceListener- Herança
- Herança
Observações
A saída de rastreio está em um formato de texto delimitado que usa o delimitador especificado pela propriedade Delimiter. O delimitador é usado para terminar cada campo numa linha de saída. Por exemplo, para mostrar a saída de traço numa folha de cálculo do Microsoft Excel, pode especificar uma vírgula (",") como delimitador e criar um ficheiro de valor separado por vírgulas (CSV).
Importante
Este tipo implementa a interface IDisposable. Quando terminar de usar o tipo, você deve eliminá-lo direta ou indiretamente. Para descartar diretamente o tipo, chama-se o seu Dispose método numtry/catch bloco. 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.
Podes criar um no DelimitedListTraceListener teu código. Alternativamente, apenas nas aplicações .NET Framework, podes ativar ou desativar um DelimitedListTraceListener através do ficheiro de configuração da aplicação e depois usar o DelimitedListTraceListener configurado na tua aplicação.
Note
Limita DelimitedListTraceListener apenas o texto que é emitido usando métodos cujos nomes começam com a palavra Trace, como DelimitedListTraceListener.TraceEvent ou Trace.TraceWarning. Os dados de traço emitidos pelo uso dos Debug.Write métodos e TextWriterTraceListener.WriteLine não são delimitados.
Para configurar um DelimitedListTraceListener numa aplicação .NET Framework, edite o ficheiro de configuração correspondente ao nome da sua aplicação. Neste ficheiro, pode adicionar um ouvinte, definir as propriedades para um ouvinte ou remover um ouvinte. O ficheiro de configuração deve ser formatado conforme mostrado no seguinte exemplo:
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="delimitedListener"
type="System.Diagnostics.DelimitedListTraceListener"
delimiter=","
initializeData="delimitedOutput.csv"
traceOutputOptions="ProcessId, DateTime" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Note
Se tentar escrever num ficheiro que esteja em uso ou indisponível, o nome do ficheiro é automaticamente prefixado por um GUID.
Note
Os ouvintes destinam-se a serem usados por métodos das Debugclasses , Trace, e TraceSource para escrever informação de traço. Os métodos de ouvinte, exceto os construtores, não devem ser chamados diretamente a partir do código da aplicação.
Construtores
| Name | Descrição |
|---|---|
| DelimitedListTraceListener(Stream, String) |
Inicializa uma nova instância da DelimitedListTraceListener classe que escreve no fluxo de saída especificado e tem o nome especificado. |
| DelimitedListTraceListener(Stream) |
Inicializa uma nova instância da DelimitedListTraceListener classe que escreve no fluxo de saída especificado. |
| DelimitedListTraceListener(String, String) |
Inicializa uma nova instância da DelimitedListTraceListener classe que escreve no ficheiro especificado e tem o nome especificado. |
| DelimitedListTraceListener(String) |
Inicializa uma nova instância da DelimitedListTraceListener classe que escreve no ficheiro especificado. |
| DelimitedListTraceListener(TextWriter, String) |
Inicializa uma nova instância da DelimitedListTraceListener classe que escreve para o autor do texto especificado e tem o nome especificado. |
| DelimitedListTraceListener(TextWriter) |
Inicializa uma nova instância da DelimitedListTraceListener classe que escreve para o autor do texto especificado. |
Propriedades
| Name | Descrição |
|---|---|
| Attributes |
Obtém os atributos personalizados do ouvinte de rastreio definidos no ficheiro de configuração da aplicação. (Herdado de TraceListener) |
| Delimiter |
Obtém ou define o delimitador para a lista delimitada. |
| 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. (Herdado de TextWriterTraceListener) |
Métodos
| Name | Descrição |
|---|---|
| Close() |
Fecha o Writer para que já não receba saída de rastreamento ou depuração. (Herdado de TextWriterTraceListener) |
| 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. (Herdado de TextWriterTraceListener) |
| 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. (Herdado de TextWriterTraceListener) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Obsoleto.
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() |
Devolve o atributo do ficheiro de configuração personalizado suportado pelo ouvinte de traços delimitado. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obsoleto.
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 rastreio, um objeto de dados e informações de eventos no ficheiro de saída ou fluxo. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Escreve informação de traço, um array de objetos de dados e informações de eventos no ficheiro de saída ou fluxo. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Escreve informação de traço, um array formatado de objetos e informação de eventos no ficheiro ou fluxo de saída. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Escreve informações de rastreio, uma mensagem e informações de eventos no ficheiro de saída ou fluxo. |
| 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. (Herdado de TextWriterTraceListener) |
| 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). (Herdado de TextWriterTraceListener) |
