Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe TraceListener

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Diagnostics
Assembly:  System (in System.dll)


[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public abstract class TraceListener : MarshalByRefObject, IDisposable

NomeDescrizione
System_CAPS_protmethodTraceListener()

Inizializza una nuova istanza della classe TraceListener.

System_CAPS_protmethodTraceListener(String)

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

NomeDescrizione
System_CAPS_pubpropertyAttributes

Ottiene gli attributi personalizzati del listener di traccia definiti nel file di configurazione dell'applicazione.

System_CAPS_pubpropertyFilter

Ottiene e imposta il filtro di traccia per il listener di traccia.

System_CAPS_pubpropertyIndentLevel

Ottiene o imposta il livello di rientro.

System_CAPS_pubpropertyIndentSize

Ottiene o imposta il numero di spazi in un rientro.

System_CAPS_pubpropertyIsThreadSafe

Ottiene un valore che indica se il listener di traccia è thread-safe.

System_CAPS_pubpropertyName

Ottiene o imposta un nome per l'oggetto TraceListener.

System_CAPS_protpropertyNeedIndent

Ottiene o imposta un valore che indica se impostare il rientro dell'output.

System_CAPS_pubpropertyTraceOutputOptions

Ottiene o imposta le opzioni dell'output di traccia.

NomeDescrizione
System_CAPS_pubmethodClose()

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.

System_CAPS_pubmethodCreateObjRef(Type)

Crea un oggetto che contiene le informazioni necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Rilascia tutte le risorse usate da TraceListener.

System_CAPS_protmethodDispose(Boolean)

Rilascia le risorse non gestite usate da TraceListener e, facoltativamente, le risorse gestite.

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.(Ereditato da Object.)

System_CAPS_pubmethodFail(String)

Genera un messaggio di errore nel listener creato durante l'implementazione della classe TraceListener.

System_CAPS_pubmethodFail(String, String)

Genera un messaggio di errore e un messaggio di errore dettagliato nel listener creato durante l'implementazione della classe TraceListener.

System_CAPS_protmethodFinalize()

Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection.(Ereditato da Object.)

System_CAPS_pubmethodFlush()

Quando se ne esegue l'override in una classe derivata, scarica il buffer di output.

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.(Ereditato da MarshalByRefObject.)

System_CAPS_protmethodGetSupportedAttributes()

Ottiene gli attributi personalizzati supportati dal listener di traccia.

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.(Ereditato da MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficiale dell'oggetto corrente MarshalByRefObject oggetto.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente.(Ereditato da Object.)

System_CAPS_pubmethodTraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Scrive le informazioni di traccia, un oggetto dati e le informazioni di evento nell'output specifico del listener.

System_CAPS_pubmethodTraceData(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.

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32)

Scrive le informazioni di traccia e di evento nell'output specifico del listener.

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Scrive le informazioni di traccia, un messaggio e le informazioni di evento nell'output specifico del listener.

System_CAPS_pubmethodTraceEvent(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.

System_CAPS_pubmethodTraceTransfer(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.

System_CAPS_pubmethodWrite(Object)

Scrive il valore del metodo ToString dell'oggetto nel listener creato durante l'implementazione della classe TraceListener.

System_CAPS_pubmethodWrite(Object, String)

Scrive un nome di categoria e il valore del metodo ToString dell'oggetto nel listener creato durante l'implementazione della classe TraceListener.

System_CAPS_pubmethodWrite(String)

Quando se ne esegue l'override in una classe derivata, scrive il messaggio specificato nel listener creato nella classe derivata.

System_CAPS_pubmethodWrite(String, String)

Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe TraceListener.

System_CAPS_protmethodWriteIndent()

Inserisce il rientro nel listener creato quando si implementa questa classe e reimposta la proprietà NeedIndent su false.

System_CAPS_pubmethodWriteLine(Object)

Scrive il valore del metodo ToString dell'oggetto nel listener creato durante l'implementazione della classe TraceListener, seguito da un terminatore di riga.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

For examples of how to implement a T:System.Diagnostics.TraceListener, see the T:System.Diagnostics.DefaultTraceListener, T:System.Diagnostics.TextWriterTraceListener and the T:System.Diagnostics.EventLogTraceListener classes.

You must enable tracing or debugging to use a trace listener. The following syntax is compiler specific. If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • 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, add the /d:DEBUG=True flag to the compiler command line.

  • 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, add the /d:TRACE=True flag to the compiler command line.

To add a trace listener, edit the configuration file that corresponds to the name of your application. 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. 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>

For more information on using configuration files for tracing, see <system.diagnostics> Element.

Note per gli eredi:

Inherit from this class to implement a custom listener for the T:System.Diagnostics.Debug and T:System.Diagnostics.Trace classes. At a minimum, you must implement the M:System.Diagnostics.TraceListener.Write(System.String) and M:System.Diagnostics.TraceListener.WriteLine(System.String) methods. Additionally, you can implement the M:System.Diagnostics.TraceListener.Fail(System.String), M:System.Diagnostics.TraceListener.Close and M:System.Diagnostics.TraceListener.Flush methods.

.NET Framework
Disponibile da 1.1

This type is thread safe.

Torna all'inizio
Mostra: