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 Trace

 

Data di pubblicazione: ottobre 2016

Fornisce un set di metodi e proprietà che consentono di tracciare l'esecuzione del codice. Questa classe non può essere ereditata.

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

System.Object
  System.Diagnostics.Trace

public sealed class Trace

NomeDescrizione
System_CAPS_pubpropertySystem_CAPS_staticAutoFlush

Ottiene o imposta un valore che indica se chiamare il metodo Flush sulla proprietà Listeners dopo ogni operazione di scrittura.

System_CAPS_pubpropertySystem_CAPS_staticCorrelationManager

Ottiene il gestore di correlazioni per il thread per la traccia.

System_CAPS_pubpropertySystem_CAPS_staticIndentLevel

Ottiene o imposta il livello di rientro.

System_CAPS_pubpropertySystem_CAPS_staticIndentSize

Ottiene o imposta il numero di spazi in un rientro.

System_CAPS_pubpropertySystem_CAPS_staticListeners

Ottiene la raccolta di listener che esegue il monitoraggio dell'output di traccia.

System_CAPS_pubpropertySystem_CAPS_staticUseGlobalLock

Ottiene o imposta un valore che indica se deve essere usato il blocco globale.

NomeDescrizione
System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean)

Controlla una condizione. Se la condizione è false, viene visualizzata una finestra di messaggio contenente lo stack di chiamate.

System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean, String)

Controlla una condizione. Se la condizione è false, genera un messaggio specificato e visualizza una finestra di messaggio contenente lo stack di chiamate.

System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean, String, String)

Controlla una condizione. Se la condizione è false, vengono generati due messaggi specificati e viene visualizzata una finestra di messaggio contenente lo stack di chiamate.

System_CAPS_pubmethodSystem_CAPS_staticClose()

Scarica il buffer di output, quindi chiude l'oggetto Listeners.

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_pubmethodSystem_CAPS_staticFail(String)

Genera il messaggio di errore specificato.

System_CAPS_pubmethodSystem_CAPS_staticFail(String, String)

Genera un messaggio di errore e un messaggio di errore dettagliato.

System_CAPS_pubmethodSystem_CAPS_staticFlush()

Svuota il buffer di output e determina la scrittura dei dati del buffer in Listeners.

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetType()

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

System_CAPS_pubmethodSystem_CAPS_staticIndent()

Incrementa la proprietà IndentLevel corrente di uno.

System_CAPS_pubmethodSystem_CAPS_staticRefresh()

Aggiorna i dati configurazione di traccia.

System_CAPS_pubmethodToString()

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

System_CAPS_pubmethodSystem_CAPS_staticTraceError(String)

Scrive un messaggio di errore nei listener di traccia della raccolta Listeners usando il messaggio specificato.

System_CAPS_pubmethodSystem_CAPS_staticTraceError(String, Object[])

Scrive un messaggio di errore nei listener di traccia della raccolta Listeners usando la matrice di oggetti e le informazioni di formattazione specificate.

System_CAPS_pubmethodSystem_CAPS_staticTraceInformation(String)

Scrive un messaggio informativo nei listener di traccia della raccolta Listeners usando il messaggio specificato.

System_CAPS_pubmethodSystem_CAPS_staticTraceInformation(String, Object[])

Scrive un messaggio informativo nei listener di traccia della raccolta Listeners usando la matrice di oggetti e le informazioni di formattazione specificate.

System_CAPS_pubmethodSystem_CAPS_staticTraceWarning(String)

Scrive un messaggio di avviso nei listener di traccia della raccolta Listeners usando il messaggio specificato.

System_CAPS_pubmethodSystem_CAPS_staticTraceWarning(String, Object[])

Scrive un messaggio di avviso nei listener di traccia della raccolta Listeners usando la matrice di oggetti e le informazioni di formattazione specificate.

System_CAPS_pubmethodSystem_CAPS_staticUnindent()

Riduce l'oggetto IndentLevel corrente di uno.

System_CAPS_pubmethodSystem_CAPS_staticWrite(Object)

Scrive il valore del metodo ToString dell'oggetto nei listener di traccia nella raccolta Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWrite(Object, String)

Scrive un nome di categoria e il valore del metodo ToString dell'oggetto nei listener di traccia nella raccolta Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWrite(String)

Scrive un messaggio nei listener di traccia della raccolta Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWrite(String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia della raccolta Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, Object)

Scrive il valore del metodo ToString dell'oggetto nei listener di traccia nella raccolta Listeners se una condizione è true.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, Object, String)

Scrive un nome di categoria e il valore del metodo ToString dell'oggetto nei listener di traccia nella raccolta Listeners se una condizione è true.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, String)

Scrive un messaggio ai listener di traccia della raccolta Listeners se una condizione è true.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia della raccolta Listeners se una condizione è true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(Object)

Scrive il valore del metodo ToString dell'oggetto nei listener di traccia nella raccolta Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(Object, String)

Scrive un nome di categoria e il valore del metodo ToString dell'oggetto nei listener di traccia nella raccolta Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(String)

Scrive un messaggio nei listener di traccia della raccolta Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia della raccolta Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, Object)

Scrive il valore del metodo ToString dell'oggetto nei listener di traccia nella raccolta Listeners se una condizione è true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, Object, String)

Scrive un nome di categoria e il valore del metodo ToString dell'oggetto nei listener di traccia nella raccolta Listeners se una condizione è true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, String)

Scrive un messaggio ai listener di traccia della raccolta Listeners se una condizione è true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia della raccolta Listeners se una condizione è true.

È possibile utilizzare le proprietà e i metodi di Trace classe alla versione di instrumentare Compila. Strumentazione consente di monitorare l'integrità dell'applicazione in esecuzione in reali. Traccia consente di isolare i problemi e risolverli senza interferire con un sistema in esecuzione.

Questa classe fornisce metodi per visualizzare un Assert nella finestra di dialogo e di generare un'asserzione che verrà sempre Fail. Questa classe fornisce i metodi di scrittura nelle seguenti variazioni: Write, WriteLine, WriteIf, e WriteLineIf.

Il BooleanSwitch e TraceSwitch classi consentono di controllare dinamicamente l'output di traccia. È possibile modificare i valori di queste opzioni senza ricompilare l'applicazione. Per informazioni sull'utilizzo del file di configurazione per impostare un'opzione, vedere la Switch classe e il How to: Create, Initialize and Configure Trace Switches argomento.

È possibile personalizzare la destinazione dell'output di tracciatura aggiungendo TraceListener istanze o la rimozione di istanze di Listeners insieme. Il Listeners insieme è condiviso da entrambi il Debug e Trace classi, aggiunta di un listener di traccia per delle classi viene aggiunto il listener a entrambi. Per impostazione predefinita, l'output di traccia viene generato mediante la DefaultTraceListener classe.

System_CAPS_noteNota

Aggiunta di un listener di traccia per il Listeners può causare un'eccezione generata durante la traccia, se una risorsa utilizzata dal listener di traccia non è disponibile. Le condizioni e l'eccezione generata dipendono dal listener di traccia e non può essere enumerati in questo argomento. Potrebbe essere utile effettuare chiamate per il Trace metodi try/catch blocchi per rilevare e gestire qualsiasi eccezione dai listener di traccia.

System_CAPS_noteNota

Se si aggiungono i listener di traccia al codice parzialmente attendibile, si otterrà un'eccezione SecurityException, perché l'aggiunta dei listener di traccia richiede l'autorizzazione UnmanagedCode. Per tracciare il codice parzialmente attendibile in esecuzione in una sandbox di Visual Studio, non aggiungere i listener di traccia. Visualizzare invece i messaggi Trace e Debug nella finestra Output.

La Trace classe fornisce le proprietà per ottenere o impostare il livello di Indent, IndentSize, e se AutoFlush dopo ogni operazione di scrittura.

Per impostare il AutoFlush e IndentSize per Trace, è possibile modificare il file di configurazione che corrisponde al nome dell'applicazione. Il file di configurazione deve essere formattato come nell'esempio seguente:

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

Il ConditionalAttribute attributo viene applicato ai metodi di Trace. I compilatori che supportano ConditionalAttribute ignorano le chiamate a questi metodi, a meno che "TRACE" è definito come simbolo di compilazione condizionale. Fare riferimento alla documentazione del compilatore per determinare se ConditionalAttribute è supportato e la sintassi per la definizione di un simbolo di compilazione condizionale.

System_CAPS_noteNota

Nei progetti di Visual Studio, il simbolo di compilazione condizionale "DEBUG" è per impostazione predefinita definito per le compilazioni di debug, mentre il simbolo "TRACE" è definito sia per le compilazioni di debug che di rilascio. Per informazioni su come disabilitare questo comportamento, vedere la documentazione di Visual Studio.

Per definire il simbolo di compilazione condizionale "DEBUG" in C#, aggiungere l'opzione /d:TRACE alla riga di comando del compilatore durante la compilazione del codice mediante una riga di comando oppure aggiungere #define TRACE all'inizio del file. In Visual Basic, aggiungere il /d:TRACE=True opzione alla riga di comando del compilatore o aggiungere #Const TRACE=True al file.

ConditionalAttribute non è supportata dal compilatore C++. Per fornire funzionalità equivalenti, è necessario racchiudere le chiamate ai metodi di Trace in un #if defined(TRACE) ... #endif bloccare, quindi aggiungere il /DTRACE opzione alla riga di comando del compilatore o aggiungere #define TRACE al file.

Nell'esempio seguente viene utilizzato Trace per indicare l'inizio e fine dell'esecuzione del programma. Nell'esempio viene inoltre utilizzata la Trace.Indent e Trace.Unindent metodi per distinguere l'output di traccia. Per un esempio più completo dell'utilizzo di Trace, vedere How to: Add Trace Statements to Application Code.

// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Trace.AutoFlush = true;
       Trace.Indent();
       Trace.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Trace.WriteLine("Exiting Main"); 
       Trace.Unindent();
    }
}

SecurityPermission

for operating with unmanaged code. Security action: F:System.Security.Permissions.SecurityAction.Demand. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

.NET Framework
Disponibile da 1.1

Questo tipo è thread-safe.

Torna all'inizio
Mostra: