DelimitedListTraceListener Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Indirizza l'output di traccia o debug a un writer di testo, ad esempio un writer di flusso o a un flusso, ad esempio un flusso di file.
public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListenerpublic class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListenertype DelimitedListTraceListener = class
inherit TextWriterTraceListenerPublic Class DelimitedListTraceListener
Inherits TextWriterTraceListener- Ereditarietà
- Ereditarietà
Commenti
L'output di traccia è in un formato di testo delimitato che usa il delimitatore specificato dalla proprietà Delimiter. Il delimitatore viene usato per terminare ogni campo in una riga di output. Ad esempio, per visualizzare l'output di traccia in un foglio di calcolo di Microsoft Excel, è possibile specificare una virgola (",") come delimitatore e creare un file con valori delimitati da virgole (CSV).
Importante
Questo tipo implementa l'interfaccia IDisposable . Al termine dell'uso del tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il Dispose relativo metodo in untry/catch blocco. Per eliminarlo indirettamente, usare un costrutto del linguaggio, ad using esempio (in C#) o Using (in Visual Basic). Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable .
È possibile creare un oggetto DelimitedListTraceListener nel codice. In alternativa, solo nelle app .NET Framework è possibile abilitare o disabilitare un DelimitedListTraceListener tramite il file di configurazione dell'applicazione e quindi usare il configurato DelimitedListTraceListener nell'applicazione.
Annotazioni
DelimitedListTraceListener Delimita solo il testo generato usando i metodi con nomi che iniziano con la parola Trace, ad esempio DelimitedListTraceListener.TraceEvent o Trace.TraceWarning. I dati di traccia generati tramite i Debug.Write metodi e TextWriterTraceListener.WriteLine non sono delimitati.
Per configurare un DelimitedListTraceListener oggetto in un'app .NET Framework, modificare il file di configurazione corrispondente al nome dell'applicazione. In questo file è possibile aggiungere un listener, impostare le proprietà per un listener o rimuovere un listener. Il file di configurazione deve essere formattato come illustrato nell'esempio seguente:
<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>
Annotazioni
Se si tenta di scrivere in un file in uso o non disponibile, il nome del file viene preceduto automaticamente da un GUID.
Annotazioni
I listener devono essere usati dai metodi delle Debugclassi , Tracee TraceSource per scrivere informazioni di traccia. I metodi del listener, ad eccezione dei costruttori, non devono essere chiamati direttamente dal codice dell'applicazione.
Costruttori
| Nome | Descrizione |
|---|---|
| DelimitedListTraceListener(Stream, String) |
Inizializza una nuova istanza della DelimitedListTraceListener classe che scrive nel flusso di output specificato e ha il nome specificato. |
| DelimitedListTraceListener(Stream) |
Inizializza una nuova istanza della DelimitedListTraceListener classe che scrive nel flusso di output specificato. |
| DelimitedListTraceListener(String, String) |
Inizializza una nuova istanza della DelimitedListTraceListener classe che scrive nel file specificato e ha il nome specificato. |
| DelimitedListTraceListener(String) |
Inizializza una nuova istanza della DelimitedListTraceListener classe che scrive nel file specificato. |
| DelimitedListTraceListener(TextWriter, String) |
Inizializza una nuova istanza della DelimitedListTraceListener classe che scrive nel writer di testo specificato e ha il nome specificato. |
| DelimitedListTraceListener(TextWriter) |
Inizializza una nuova istanza della DelimitedListTraceListener classe che scrive nel writer di testo specificato. |
Proprietà
| Nome | Descrizione |
|---|---|
| Attributes |
Ottiene gli attributi del listener di traccia personalizzati definiti nel file di configurazione dell'applicazione. (Ereditato da TraceListener) |
| Delimiter |
Ottiene o imposta il delimitatore per l'elenco delimitato. |
| Filter |
Ottiene o imposta il filtro di traccia per il listener di traccia. (Ereditato da TraceListener) |
| IndentLevel |
Ottiene o imposta il livello di rientro. (Ereditato da TraceListener) |
| IndentSize |
Ottiene o imposta il numero di spazi in un rientro. (Ereditato da TraceListener) |
| IsThreadSafe |
Ottiene un valore che indica se il listener di traccia è thread-safe. (Ereditato da TraceListener) |
| Name |
Ottiene o imposta un nome per l'oggetto TraceListener. (Ereditato da TraceListener) |
| NeedIndent |
Ottiene o imposta un valore che indica se impostare il rientro dell'output. (Ereditato da TraceListener) |
| TraceOutputOptions |
Ottiene o imposta le opzioni di output della traccia. (Ereditato da TraceListener) |
| Writer |
Ottiene o imposta il writer di testo che riceve l'output di traccia o debug. (Ereditato da TextWriterTraceListener) |
Metodi
| Nome | Descrizione |
|---|---|
| Close() |
Chiude in modo che non riceva più l'output Writer di traccia o debug. (Ereditato da TextWriterTraceListener) |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| Dispose() |
Rilascia tutte le risorse usate da TraceListener. (Ereditato da TraceListener) |
| Dispose(Boolean) |
Elimina questo TextWriterTraceListener oggetto. (Ereditato da TextWriterTraceListener) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| Fail(String, String) |
Genera un messaggio di errore e un messaggio di errore dettagliato al listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Fail(String) |
Genera un messaggio di errore al listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Flush() |
Scarica il buffer di output per .Writer (Ereditato da TextWriterTraceListener) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetSupportedAttributes() |
Restituisce l'attributo del file di configurazione personalizzato supportato dal listener di traccia delimitato. |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Scrive informazioni di traccia, un oggetto dati e informazioni sugli eventi nel file o nel flusso di output. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Scrive informazioni di traccia, una matrice di oggetti dati e informazioni sugli eventi nel file o nel flusso di output. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Scrive informazioni di traccia, una matrice formattata di oggetti e informazioni sugli eventi nel file di output o nel flusso. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Scrive informazioni di traccia, un messaggio e informazioni sugli eventi nel file di output o nel flusso. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Scrive le informazioni di traccia e evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Scrive informazioni di traccia, un messaggio, un'identità di attività correlata e informazioni sugli eventi nell'output specifico del listener. (Ereditato da TraceListener) |
| Write(Object, String) |
Scrive un nome di categoria e il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(Object) |
Scrive il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(String, String) |
Scrive un nome di categoria e un messaggio nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(String) |
Scrive un messaggio nell'istanza di Writer. (Ereditato da TextWriterTraceListener) |
| WriteIndent() |
Scrive il rientro nel listener creato quando si implementa questa classe e la proprietà viene reimpostata NeedIndent su |
| WriteLine(Object, String) |
Scrive un nome di categoria e il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe, seguita da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(Object) |
Scrive il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe, seguita da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(String, String) |
Scrive un nome di categoria e un messaggio nel listener creato quando si implementa la TraceListener classe , seguito da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(String) |
Scrive un messaggio in Writer questa istanza seguito da un terminatore di riga. Il carattere di terminazione della riga predefinito è un ritorno a capo seguito da un avanzamento riga (\r\n). (Ereditato da TextWriterTraceListener) |
