<System. Diagnostics> elemento<system.diagnostics> Element

Specifica i listener di traccia per raccogliere, archiviare e indirizzare i messaggi, oltre al livello di impostazione di un'opzione di traccia.Specifies trace listeners that collect, store, and route messages and the level where a trace switch is set.

<configuration><configuration>
<System. Diagnostics ><system.diagnostics>

SintassiSyntax

<system.diagnostics>   
</system.diagnostics>  

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

Nessuno.None.

Elementi figlioChild Elements

ElementoElement DescrizioneDescription
<assert><assert> Specifica se visualizzare una finestra di messaggio quando si chiama il metodo Debug.Assert. Specifica anche il nome del file in cui scrivere i messaggi.Specifies whether to display a message box when you call the Debug.Assert method; also specifies the name of the file to write messages to.
<performanceCounters><performanceCounters> Specifica le dimensioni della memoria globale condivisa dai contatori delle prestazioni.Specifies the size of the global memory shared by performance counters.
<sharedListeners><sharedListeners> Contiene i listener a cui può fare riferimento qualsiasi origine o elemento di traccia.Contains listeners that any source or trace element can reference. I listener identificati come condivisi possono essere aggiunti alle origini o le tracce in base al nome.Listeners identified as shared listeners can be added to sources or traces by name.
<sources><sources> Specifica le origini di traccia che avviano i messaggi di traccia.Specifies trace sources that initiate tracing messages.
<switches><switches> Contiene le opzioni di traccia e i livelli in cui vengono impostate le opzioni di traccia.Contains trace switches and the levels where the trace switches are set.
<trace><trace> Contiene i listener che raccolgono, archiviano e indirizzano i messaggi di traccia.Contains listeners that collect, store, and route tracing messages.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.

EsempioExample

Nell'esempio seguente viene illustrato come incorporare un'opzione di traccia e un listener di traccia all'interno di <System. Diagnostics > elemento.The following example shows how to embed a trace switch and a trace listener inside the <system.diagnostics> element. Il General è impostata l'opzione di traccia di TraceLevel livello.The General trace switch is set to the TraceLevel level. Il listener di traccia myListener crea un file denominato MyListener.log e scrive l'output del file.The trace listener myListener creates a file called MyListener.log and writes the output to the file.

Nota

In .NET Framework versione 2.0 è possibile usare testo per specificare il valore di un'opzione,In the .NET Framework version 2.0, you can use text to specify the value for a switch. Ad esempio, è possibile specificare true per un BooleanSwitch o il testo che rappresenta un valore di enumerazione, ad esempio Error per un TraceSwitch.For example, you can specify true for a BooleanSwitch or use the text representing an enumeration value such as Error for a TraceSwitch. La riga <add name="myTraceSwitch" value="Error" /> equivale a <add name="myTraceSwitch" value="1" />.The line <add name="myTraceSwitch" value="Error" /> is equivalent to <add name="myTraceSwitch" value="1" />.

<configuration>  
   <system.diagnostics>  
      <switches>  
         <add name="General" value="4" />  
      </switches>  
      <trace autoflush="true" indentsize="2">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>  

Vedere ancheSee Also

Trace
Debug
Schema delle impostazioni di traccia e debugTrace and Debug Settings Schema