TraceListener Classe

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Origine:

TraceListener.cs

Fornisce la classe base abstract per i listener che eseguono il monitoraggio dell'output di traccia e di debug.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable

public abstract class TraceListener : MarshalByRefObject, IDisposable

type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable

Ereditarietà

Object

MarshalByRefObject

TraceListener

Derivato

Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

System.Web.IisTraceListener

System.Web.WebPageTraceListener

Implementazioni

IDisposable

Commenti

Per esempi di come implementare un TraceListeneroggetto , vedere le TextWriterTraceListenerDefaultTraceListenerclassi e EventLogTraceListener .

È necessario abilitare la traccia o il debug per usare un listener di traccia. La sintassi seguente è specifica del compilatore. Se si usano compilatori diversi da C# o Visual Basic, vedere la documentazione relativa al compilatore.

• Per abilitare il debug in C#, aggiungere il /d:DEBUG flag alla riga di comando del compilatore quando si compila il codice oppure aggiungere #define DEBUG all'inizio del file. In Visual Basic aggiungere il /d:DEBUG=True flag alla riga di comando del compilatore.

• Per abilitare la traccia in C#, aggiungere il /d:TRACE flag alla riga di comando del compilatore quando si compila il codice o aggiungerlo #define TRACE all'inizio del file. In Visual Basic aggiungere il /d:TRACE=True flag alla riga di comando del compilatore.

Per aggiungere un listener di traccia, modificare il file di configurazione corrispondente al nome dell'applicazione. All'interno di questo file è possibile aggiungere un listener, impostarne il tipo e impostarne il parametro, rimuovere un listener o cancellare tutti i listener impostati in precedenza dall'applicazione. Il file di configurazione deve essere formattato in modo simile all'esempio seguente.

<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>  

Per altre informazioni sull'uso dei file di configurazione per la traccia, vedere <system.diagnostics>.

Note per gli implementatori

Ereditare da questa classe per implementare un listener personalizzato per le Debug classi e Trace . È necessario implementare almeno i Write(String) metodi e WriteLine(String) . Inoltre, è possibile implementare i Fail(String)metodi , Close() e Flush() .

Costruttori

TraceListener()	Inizializza una nuova istanza della classe TraceListener.
TraceListener(String)	Inizializza una nuova istanza della classe TraceListener usando il nome specificato come listener.

Proprietà

Attributes	Ottiene gli attributi personalizzati del listener di traccia definiti nel file di configurazione dell'applicazione.
Filter	Ottiene o imposta il filtro di traccia per il listener di traccia.
IndentLevel	Ottiene o imposta il livello di rientro.
IndentSize	Ottiene o imposta il numero di spazi in un rientro.
IsThreadSafe	Ottiene un valore che indica se il listener di traccia è thread-safe.
Name	Ottiene o imposta un nome per l'oggetto TraceListener.
NeedIndent	Ottiene o imposta un valore che indica se impostare il rientro dell'output.
TraceOutputOptions	Ottiene o imposta le opzioni dell'output di traccia.

Metodi

Close()	Quando se ne esegue l'override in una classe derivata, chiude il flusso di output in modo da bloccare la ricezione di output di tracciatura o di debug.
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.
Dispose(Boolean)	Rilascia le risorse non gestite usate da TraceListener e, facoltativamente, le risorse gestite.
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.
Fail(String, String)	Genera un messaggio di errore e un messaggio di errore dettagliato nel listener creato durante l'implementazione della classe TraceListener.
Flush()	Quando se ne esegue l'override in una classe derivata, scarica il buffer di output.
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()	Ottiene gli attributi personalizzati supportati dal listener di traccia.
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 le informazioni di traccia, un oggetto dati e le informazioni di evento nell'output specifico del listener.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Scrive le informazioni di traccia, una matrice di oggetti dati e le informazioni di evento nell'output specifico del listener.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Scrive le informazioni di traccia e di evento nell'output specifico del listener.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Scrive le informazioni di traccia, un messaggio e le informazioni di evento nell'output specifico del listener.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Scrive le informazioni di traccia, una matrice di oggetti formattata e le informazioni di evento nell'output specifico del listener.
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.
Write(Object)	Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe 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.
Write(String)	Quando se ne esegue l'override in una classe derivata, scrive il messaggio specificato nel listener creato nella classe derivata.
Write(String, String)	Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe TraceListener.
WriteIndent()	Inserisce il rientro nel listener creato quando si implementa questa classe e reimposta la proprietà NeedIndent su false.
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.
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.
WriteLine(String)	Quando se ne esegue l'override in una classe derivata, scrive un messaggio nel listener creato nella classe derivata, seguito da un terminatore di riga.
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.

Thread safety

Questo tipo è thread-safe.

Vedi anche

• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace
• <Elemento system.diagnostics>