TraceListener Classe

Definizione

Spazio dei nomi:
System.Diagnostics
Assembly:
System.dll
Assembly:
netstandard.dll

Fornisce la abstract classe di base per i listener che monitorano l'output di traccia e 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
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 per il compilatore.

  • Per abilitare il debug in C#, aggiungere il /d:DEBUG flag alla riga di comando del compilatore durante la compilazione del 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

Nome Descrizione
TraceListener()

Inizializza una nuova istanza della classe TraceListener.
TraceListener(String)

Inizializza una nuova istanza della TraceListener classe utilizzando il nome specificato come listener.

Proprietà

Nome Descrizione
Attributes

Ottiene gli attributi del listener di traccia personalizzati 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 di output della traccia.

Metodi

Nome Descrizione
Close()

Quando sottoposto a override in una classe derivata, chiude il flusso di output in modo che non riceva più l'output di traccia o debug.
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.
Dispose(Boolean)

Rilascia le risorse non gestite usate da TraceListener e, facoltativamente, rilascia le risorse gestite.
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 .
Fail(String)

Genera un messaggio di errore al listener creato quando si implementa la TraceListener classe .
Flush()

Quando sottoposto a override in una classe derivata, scarica il buffer di output.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
GetSupportedAttributes()

Ottiene gli attributi personalizzati supportati dal listener di traccia.
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()

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 nell'output specifico del listener.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Scrive informazioni di traccia, una matrice di oggetti dati e informazioni sugli eventi nell'output specifico del listener.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Scrive informazioni di traccia, una matrice formattata di oggetti e informazioni sugli eventi nell'output specifico del listener.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Scrive informazioni di traccia, un messaggio e informazioni sull'evento nell'output specifico del listener.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Scrive le informazioni di traccia e evento nell'output specifico del listener.
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.
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 .
Write(Object)

Scrive il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe .
Write(String, String)

Scrive un nome di categoria e un messaggio nel listener creato quando si implementa la TraceListener classe .
Write(String)

Quando sottoposto a override in una classe derivata, scrive il messaggio specificato nel listener creato nella classe derivata.
WriteIndent()

Scrive il rientro nel listener creato quando si implementa questa classe e la proprietà viene reimpostata NeedIndent su false.
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.
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.
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.
WriteLine(String)

Quando sottoposto a override in una classe derivata, scrive un messaggio nel listener creato nella classe derivata, seguito da un terminatore di riga.

Si applica a

Thread safety

Questo tipo è thread-safe.

Vedi anche