Trace Classe

Definizione

Viene fornita una serie di metodi e proprietà per la tracciatura dell'esecuzione del codice.Provides a set of methods and properties that help you trace the execution of your code. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class Trace sealed
public sealed class Trace
type Trace = class
Public NotInheritable Class Trace
Ereditarietà
Trace

Esempi

Nell'esempio seguente viene Trace usato per indicare l'inizio e la fine dell'esecuzione di un programma.The following example uses Trace to indicate the beginning and the end of a program's execution. Nell'esempio vengono inoltre utilizzati Trace.Indent i Trace.Unindent metodi e per distinguere l'output di traccia.The example also uses the Trace.Indent and Trace.Unindent methods to distinguish the tracing output. Per un esempio più completo dell'uso di Trace, vedere procedura: Aggiungere istruzioni di traccia al codicedell'applicazione.For a more complete example of the use of Trace, see How to: Add Trace Statements to Application Code.

// Specify /DTRACE when compiling.

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;

int main()
{
   #if defined(TRACE)
   Trace::Listeners->Add( gcnew TextWriterTraceListener( Console::Out ) );
   Trace::AutoFlush = true;
   Trace::Indent();
   Trace::WriteLine( "Entering Main" );
   #endif
   Console::WriteLine( "Hello World." );
   #if defined(TRACE)
   Trace::WriteLine( "Exiting Main" );
   Trace::Unindent();
   #endif
   return 0;
}
// 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();
    }
}
' Specify /d:TRACE=True when compiling.

Imports System.Diagnostics

Class Test
    
    Shared Sub 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()
        
    End Sub

End Class

Commenti

È possibile utilizzare le proprietà e i metodi Trace della classe per instrumentare le build di rilascio.You can use the properties and methods in the Trace class to instrument release builds. La strumentazione consente di monitorare l'integrità dell'applicazione in esecuzione in impostazioni reali.Instrumentation allows you to monitor the health of your application running in real-life settings. La traccia consente di isolare i problemi e risolverli senza compromettere un sistema in esecuzione.Tracing helps you isolate problems and fix them without disturbing a running system.

Questa classe fornisce i metodi per visualizzare Assert una finestra di dialogo e per emettere un'asserzione che Failsempre.This class provides methods to display an Assert dialog box, and to emit an assertion that will always Fail. Questa classe fornisce metodi di scrittura nelle varianti seguenti: Write, WriteLine, WriteIfe WriteLineIf.This class provides write methods in the following variations: Write, WriteLine, WriteIf, and WriteLineIf.

Le BooleanSwitch classi TraceSwitch e forniscono mezzi per controllare dinamicamente l'output di traccia.The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. È possibile modificare i valori di queste opzioni senza ricompilare l'applicazione.You can modify the values of these switches without recompiling your application. Per informazioni sull'uso del file di configurazione per impostare un'opzione, vedere Switch la classe e la procedura: Argomento creare, inizializzare e configurare opzioni di traccia.For information on using the configuration file to set a switch, see the Switch class and the How to: Create, Initialize and Configure Trace Switches topic.

Per personalizzare la destinazione dell'output di traccia, è TraceListener possibile aggiungere o rimuovere istanze Listeners dalla raccolta.You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. La Listeners raccolta è condivisa dalle Debug Trace classi e. l'aggiunta di un listener di traccia a una delle due classi aggiunge il listener a entrambi.The Listeners collection is shared by both the Debug and the Trace classes; adding a trace listener to either class adds the listener to both. Per impostazione predefinita, l'output di traccia viene emesso DefaultTraceListener usando la classe.By default, trace output is emitted using the DefaultTraceListener class.

Nota

L'aggiunta di un listener di Listeners traccia alla raccolta può provocare la generazione di un'eccezione durante la traccia, se non è disponibile una risorsa utilizzata dal listener di traccia.Adding a trace listener to the Listeners collection can cause an exception to be thrown while tracing, if a resource used by the trace listener is not available. Le condizioni e l'eccezione generata dipendono dal listener di traccia e non possono essere enumerate in questo argomento.The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. Può essere utile inserire Trace le chiamate ai metodi nei try / catch blocchi per rilevare e gestire le eccezioni dai listener di traccia.It may be useful to place calls to the Trace methods in try/catch blocks to detect and handle any exceptions from trace listeners.

Nota

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.If you add trace listeners to partially trusted code, you will get a SecurityException exception, because adding trace listeners requires UnmanagedCode permission. Per tracciare il codice parzialmente attendibile in esecuzione in una sandbox di Visual Studio, non aggiungere i listener di traccia.To trace partially trusted code that is running in a sandbox in Visual Studio, do not add trace listeners. Al contrario, visualizzare Trace i Debug messaggi e nella finestra di output .Instead, view the Trace and Debug messages in the Output window.

La Trace classe fornisce le proprietà per ottenere o impostare il livello Indentdi, IndentSizee se AutoFlush dopo ogni scrittura.The Trace class provides properties to get or set the level of Indent, the IndentSize, and whether to AutoFlush after each write.

Per impostare AutoFlush e IndentSize per Trace, è possibile modificare il file di configurazione che corrisponde al nome dell'applicazione.To set the AutoFlush and IndentSize for Trace, you can edit the configuration file that corresponds to the name of your application. Il file di configurazione deve essere formattato come nell'esempio seguente:The configuration file should be formatted like the following example:

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

L' ConditionalAttribute attributo viene applicato ai metodi di Trace.The ConditionalAttribute attribute is applied to the methods of Trace. I compilatori ConditionalAttribute che supportano ignorare le chiamate a questi metodi a meno che "Trace" non sia definito come simbolo di compilazione condizionale.Compilers that support ConditionalAttribute ignore calls to these methods unless "TRACE" is defined as a conditional compilation symbol. Per determinare se ConditionalAttribute è supportato e la sintassi per la definizione di un simbolo di compilazione condizionale, fare riferimento alla documentazione del compilatore.Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

Nota

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.In Visual Studio projects, by default, the "DEBUG" conditional compilation symbol is defined for debug builds, and the "TRACE" symbol is defined for both debug and release builds. Per informazioni su come disabilitare questo comportamento, vedere la documentazione di Visual Studio.For information about how to disable this behavior, see the Visual Studio documentation.

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.To define the "TRACE" conditional compilation symbol in C#, add the /d:TRACE option to the compiler command line when you compile your code using a command line, or add #define TRACE to the top of your file. In Visual Basic aggiungere l' /d:TRACE=True opzione alla riga di comando del compilatore o aggiungere #Const TRACE=True al file.In Visual Basic, add the /d:TRACE=True option to the compiler command line or add #Const TRACE=True to the file.

ConditionalAttributenon è supportato dal C++ compilatore.ConditionalAttribute is not supported by the C++ compiler. Per fornire funzionalità equivalenti, è necessario racchiudere le chiamate ai metodi Trace di in #if defined(TRACE) ... #endif un blocco e aggiungere l' /DTRACE opzione alla riga di comando del compilatore o #define TRACE aggiungere al file.To provide equivalent functionality, you must enclose calls to the methods of Trace in an #if defined(TRACE) ... #endif block, and add the /DTRACE option to the compiler command line or add #define TRACE to the file.

Proprietà

AutoFlush

Ottiene o imposta un valore che indica se chiamare Flush() sulla classe Listeners dopo ogni operazione di scrittura.Gets or sets whether Flush() should be called on the Listeners after every write.

CorrelationManager

Ottiene il gestore di correlazioni per il thread per la traccia.Gets the correlation manager for the thread for this trace.

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.

Listeners

Ottiene l'insieme di listener che esegue il monitoraggio dell'output di traccia.Gets the collection of listeners that is monitoring the trace output.

UseGlobalLock

Ottiene o imposta un valore che indica se deve essere utilizzato il blocco globale.Gets or sets a value indicating whether the global lock should be used.

Metodi

Assert(Boolean)

Controlla una condizione. Se la condizione è false, viene visualizzata una finestra di messaggio contenente lo stack di chiamate.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String)

Controlla una condizione. Se la condizione è false, genera un messaggio specificato e visualizza una finestra di messaggio contenente lo stack di chiamate.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(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.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

Close()

Svuota il buffer di output, quindi chiude l'insieme Listeners.Flushes the output buffer, and then closes the Listeners.

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 il messaggio di errore specificato.Emits the specified error message.

Fail(String, String)

Genera un messaggio di errore e un messaggio di errore dettagliato.Emits an error message, and a detailed error message.

Flush()

Svuota il buffer di output e determina la scrittura dei dati del buffer nell'insieme Listeners.Flushes the output buffer, and causes buffered data to be written to the Listeners.

GetHashCode()

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

(Ereditato da Object)
GetType()

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

(Ereditato da Object)
Indent()

Incrementa la proprietà IndentLevel corrente di uno.Increases the current IndentLevel by one.

MemberwiseClone()

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

(Ereditato da Object)
Refresh()

Aggiorna i dati di configurazione della traccia.Refreshes the trace configuration data.

ToString()

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

(Ereditato da Object)
TraceError(String)

Scrive un messaggio di errore nei listener di traccia dell'insieme Listeners utilizzando il messaggio specificato.Writes an error message to the trace listeners in the Listeners collection using the specified message.

TraceError(String, Object[])

Scrive un messaggio di errore nei listener di traccia dell'insieme Listeners utilizzando la matrice di oggetti e le informazioni di formattazione specificate.Writes an error message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceInformation(String)

Scrive un messaggio informativo nei listener di traccia dell'insieme Listeners utilizzando il messaggio specificato.Writes an informational message to the trace listeners in the Listeners collection using the specified message.

TraceInformation(String, Object[])

Scrive un messaggio informativo nei listener di traccia dell'insieme Listeners utilizzando la matrice di oggetti e le informazioni di formattazione specificate.Writes an informational message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceWarning(String)

Scrive un messaggio di avviso nei listener di traccia dell'insieme Listeners utilizzando il messaggio specificato.Writes a warning message to the trace listeners in the Listeners collection using the specified message.

TraceWarning(String, Object[])

Scrive un messaggio di avviso nei listener di traccia dell'insieme Listeners utilizzando la matrice di oggetti e le informazioni di formattazione specificate.Writes a warning message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

Unindent()

Riduce la proprietà IndentLevel corrente di uno.Decreases the current IndentLevel by one.

Write(Object)

Scrive il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(Object, String)

Scrive il nome di una categoria e il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(String)

Scrive un messaggio nei listener di traccia dell'insieme Listeners.Writes a message to the trace listeners in the Listeners collection.

Write(String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia dell'insieme Listeners.Writes a category name and a message to the trace listeners in the Listeners collection.

WriteIf(Boolean, Object)

Scrive il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners, se una condizione è true.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, Object, String)

Scrive il nome di una categoria e il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String)

Scrive un messaggio nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

WriteLine(Object)

Scrive il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(Object, String)

Scrive il nome di una categoria e il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String)

Scrive un messaggio nei listener di traccia dell'insieme Listeners.Writes a message to the trace listeners in the Listeners collection.

WriteLine(String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia dell'insieme Listeners.Writes a category name and message to the trace listeners in the Listeners collection.

WriteLineIf(Boolean, Object)

Scrive il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners, se una condizione è true.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, Object, String)

Scrive il nome di una categoria e il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String)

Scrive un messaggio nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

Sicurezza

SecurityPermission
per l'utilizzo di codice non gestito.for operating with unmanaged code. Azione di sicurezza Demand:.Security action: Demand. Enumerazione associata:UnmanagedCodeAssociated enumeration: UnmanagedCode

Si applica a

Thread safety

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

Vedi anche