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 tracciatura o di debug a un writer di testo, quale un writer di flusso, oppure a un flusso, quale 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 Delimiter proprietà. 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
Il tipo implementa l'interfaccia IDisposable. Dopo aver utilizzato il tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il Dispose relativo metodo in untry/catch blocco. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using 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 DelimitedListTraceListener oggetto nel codice. In alternativa, nelle app .NET Framework è possibile abilitare o disabilitare un DelimitedListTraceListener tramite il file di configurazione dell'applicazione e quindi usare l'oggetto configurato DelimitedListTraceListener nell'applicazione.
Nota
Il DelimitedListTraceListener testo delimita solo il testo generato usando i metodi che hanno 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>
Nota
Se si tenta di scrivere in un file in uso o non disponibile, il nome del file viene preceduto automaticamente da un GUID.
Nota
I listener devono essere usati dai metodi delle classi , Tracee TraceSource per scrivere informazioni di Debugtraccia. I metodi listener, ad eccezione dei costruttori, non devono essere chiamati direttamente dal codice dell'applicazione.
Costruttori
| DelimitedListTraceListener(Stream) |
Inizializza una nuova istanza della classe DelimitedListTraceListener che scrive nel flusso di output specificato. |
| DelimitedListTraceListener(Stream, String) |
Inizializza una nuova istanza della classe DelimitedListTraceListener che scrive nel flusso di output specificato e ha il nome specificato. |
| DelimitedListTraceListener(String) |
Inizializza una nuova istanza della classe DelimitedListTraceListener che scrive nel file specificato. |
| DelimitedListTraceListener(String, String) |
Inizializza una nuova istanza della classe DelimitedListTraceListener che scrive nel file specificato e ha il nome specificato. |
| DelimitedListTraceListener(TextWriter) |
Inizializza una nuova istanza della classe DelimitedListTraceListener che scrive nel writer di testo specificato. |
| DelimitedListTraceListener(TextWriter, String) |
Inizializza una nuova istanza della classe DelimitedListTraceListener che scrive nel writer di testo specificato e ha il nome specificato. |
Proprietà
| Attributes |
Ottiene gli attributi personalizzati del listener di traccia 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 dell'output di traccia. (Ereditato da TraceListener) |
| Writer |
Ottiene o imposta il writer di testo che riceve l'output di tracciatura o di debug. (Ereditato da TextWriterTraceListener) |
Metodi
| Close() |
Chiude la classe Writer in modo che non riceva più output di tracciatura o di debug. (Ereditato da TextWriterTraceListener) |
| CreateObjRef(Type) |
Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| Dispose() |
Rilascia tutte le risorse usate da TraceListener. (Ereditato da TraceListener) |
| Dispose(Boolean) |
Elimina questo oggetto TextWriterTraceListener. (Ereditato da TextWriterTraceListener) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| Fail(String) |
Genera un messaggio di errore nel listener creato durante l'implementazione della classe TraceListener. (Ereditato da TraceListener) |
| Fail(String, String) |
Genera un messaggio di errore e un messaggio di errore dettagliato nel listener creato durante l'implementazione della classe TraceListener. (Ereditato da TraceListener) |
| Flush() |
Scarica il buffer di output per la classe Writer. (Ereditato da TextWriterTraceListener) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
| GetSupportedAttributes() |
Restituisce l'attributo del file di configurazione personalizzato supportato dal listener di traccia delimitato. |
| GetSupportedAttributes() |
Ottiene gli attributi personalizzati supportati dal listener di traccia. (Ereditato da TraceListener) |
| GetType() |
Ottiene l'oggetto 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 dell'oggetto Object corrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (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 di evento nel file o nel flusso di output. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Scrive informazioni di traccia, una matrice di oggetti dati e informazioni di evento nel flusso o nel file di output. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Scrive le informazioni di traccia e di evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Scrive informazioni di traccia, un messaggio e informazioni di evento nel flusso o nel file di output. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Scrive informazioni di traccia, una matrice di oggetti formattata e informazioni di evento nel flusso o nel file di output. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Scrive le informazioni di traccia, un messaggio, l'identità di un'attività correlata e le informazioni di evento nell'output specifico del listener. (Ereditato da TraceListener) |
| Write(Object) |
Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener. (Ereditato da TraceListener) |
| Write(Object, String) |
Scrive un nome di categoria e il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener. (Ereditato da TraceListener) |
| Write(String) |
Scrive un messaggio nella classe Writer di questa istanza. (Ereditato da TextWriterTraceListener) |
| Write(String, String) |
Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe TraceListener. (Ereditato da TraceListener) |
| WriteIndent() |
Inserisce il rientro nel listener creato quando si implementa questa classe e reimposta la proprietà NeedIndent su |
| WriteLine(Object) |
Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener, seguito da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(Object, String) |
Scrive un nome di categoria e il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener, seguito da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(String) |
Scrive un messaggio nella classe Writer di questa istanza, seguito da un terminatore di riga. Il terminatore di riga predefinito è un ritorno a capo seguito da un avanzamento riga (\r\n). (Ereditato da TextWriterTraceListener) |
| WriteLine(String, String) |
Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe TraceListener, seguiti da un terminatore di riga. (Ereditato da TraceListener) |
