TraceListener Classe

Definizione

Fornisce la classe base abstract per i listener che eseguono il monitoraggio dell'output di traccia e di debug.Provides the abstract base class for the listeners who monitor trace and debug output.

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à
TraceListener
Derivato
Implementazioni

Commenti

Per esempi di come implementare un oggetto TraceListener, DefaultTraceListenervedere TextWriterTraceListener e le EventLogTraceListener classi.For examples of how to implement a TraceListener, see the DefaultTraceListener, TextWriterTraceListener and the EventLogTraceListener classes.

È necessario abilitare la traccia o il debug per utilizzare un listener di traccia.You must enable tracing or debugging to use a trace listener. La sintassi seguente è specifica del compilatore.The following syntax is compiler specific. Se si usano compilatori diversi C# da o Visual Basic, fare riferimento alla documentazione del compilatore.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • Per abilitare il debug C#in, aggiungere /d:DEBUG il flag alla riga di comando del compilatore quando si compila il codice oppure è possibile #define DEBUG aggiungerlo all'inizio del file.To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. In Visual Basic aggiungere il /d:DEBUG=True flag alla riga di comando del compilatore.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • Per abilitare l'analisi C#in, aggiungere /d:TRACE il flag alla riga di comando del compilatore quando si compila il codice oppure #define TRACE aggiungerlo all'inizio del file.To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. In Visual Basic aggiungere il /d:TRACE=True flag alla riga di comando del compilatore.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

Per aggiungere un listener di traccia, modificare il file di configurazione che corrisponde al nome dell'applicazione.To add a trace listener, edit the configuration file that corresponds to the name of your application. All'interno di questo file è possibile aggiungere un listener, impostarne il tipo e impostarne il parametro, rimuovere un listener o deselezionare tutti i listener precedentemente impostati dall'applicazione.Within this file, you can add a listener, set its type and set its parameter, remove a listener, or clear all the listeners previously set by the application. Il file di configurazione deve essere formattato in modo simile all'esempio seguente.The configuration file should be formatted similar to the following example.

<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 ulteriori informazioni sull'utilizzo dei file di configurazione per la traccia, vedere <System>. Diagnostics.For more information on using configuration files for tracing, see <system.diagnostics>.

Note per gli eredi

Ereditare da questa classe per implementare un listener personalizzato per Debug le Trace classi e.Inherit from this class to implement a custom listener for the Debug and Trace classes. Come minimo, è necessario implementare i Write(String) metodi e. WriteLine(String)At a minimum, you must implement the Write(String) and WriteLine(String) methods. Inoltre, è possibile implementare i Fail(String)metodi Close() , Flush() e.Additionally, you can implement the Fail(String), Close() and Flush() methods.

Costruttori

TraceListener()

Inizializza una nuova istanza della classe TraceListener.Initializes a new instance of the TraceListener class.

TraceListener(String)

Inizializza una nuova istanza della classe TraceListener utilizzando il nome specificato come listener.Initializes a new instance of the TraceListener class using the specified name as the listener.

Proprietà

Attributes

Ottiene gli attributi personalizzati del listener di traccia definiti nel file di configurazione dell'applicazione.Gets the custom trace listener attributes defined in the application configuration file.

Filter

Ottiene o imposta il filtro di traccia per il listener di traccia.Gets or sets the trace filter for the trace listener.

IndentLevel

Ottiene o imposta il livello di rientro.Gets or sets the indent level.

IndentSize

Ottiene o imposta il numero di spazi in un rientro.Gets or sets the number of spaces in an indent.

IsThreadSafe

Ottiene un valore che indica se il listener di traccia è thread-safe.Gets a value indicating whether the trace listener is thread safe.

Name

Ottiene o imposta un nome per questa classe TraceListener.Gets or sets a name for this TraceListener.

NeedIndent

Ottiene o imposta un valore che indica se impostare il rientro dell'output.Gets or sets a value indicating whether to indent the output.

TraceOutputOptions

Ottiene o imposta le opzioni dell'output di traccia.Gets or sets the trace output options.

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.When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da TraceListener.Releases all resources used by the TraceListener.

Dispose(Boolean)

Rilascia le risorse non gestite usate da TraceListener e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Fail(String)

Genera un messaggio di errore nel listener creato durante l'implementazione della classe TraceListener.Emits an error message to the listener you create when you implement the TraceListener class.

Fail(String, String)

Genera un messaggio di errore e un messaggio di errore dettagliato nel listener creato durante l'implementazione della classe TraceListener.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

Flush()

Quando se ne esegue l'override in una classe derivata, svuota il buffer di output.When overridden in a derived class, flushes the output buffer.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetSupportedAttributes()

Ottiene gli attributi personalizzati supportati dal listener di traccia.Gets the custom attributes supported by the trace listener.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(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.Writes trace information, a data object and event information to the listener specific output.

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.Writes trace information, an array of data objects and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Scrive le informazioni di traccia e di evento nell'output specifico del listener.Writes trace and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Scrive le informazioni di traccia, un messaggio e le informazioni di evento nell'output specifico del listener.Writes trace information, a message, and event information to the listener specific output.

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.Writes trace information, a formatted array of objects and event information to the listener specific 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.Writes trace information, a message, a related activity identity and event information to the listener specific output.

Write(Object)

Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

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.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

Write(String)

Quando se ne esegue l'override in una classe derivata, scrive il messaggio specificato nel listener creato nella classe derivata.When overridden in a derived class, writes the specified message to the listener you create in the derived class.

Write(String, String)

Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe TraceListener.Writes a category name and a message to the listener you create when you implement the TraceListener class.

WriteIndent()

Inserisce il rientro nel listener creato quando si implementa questa classe e reimposta la proprietà NeedIndent su false.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to 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.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

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.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

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.When overridden in a derived class, writes a message to the listener you create in the derived class, followed by a line terminator.

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.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

Si applica a

Thread safety

Questo tipo è thread-safe.This type is thread safe.

Vedi anche