<system.diagnostics>-Element<system.diagnostics> Element

Gibt Ablaufverfolgungslistener an, die Meldungen sammeln, speichern und weiterleiten sowie die Ebene, für die ein Ablaufverfolgungsschalter festgelegt ist.Specifies trace listeners that collect, store, and route messages and the level where a trace switch is set.

<configuration>
  <system.diagnostics>

SyntaxSyntax

<system.diagnostics>
</system.diagnostics>  

Attribute und ElementeAttributes and Elements

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.The following sections describe attributes, child elements, and parent elements.

AttributeAttributes

KeineNone.

Untergeordnete ElementeChild Elements

ElementElement BESCHREIBUNGDescription
<assert> Gibt an, ob ein Meldungsfeld angezeigt wird, wenn Sie die Debug.Assert-Methode aufrufen. Außerdem wird der Name der Datei angegeben, in die die Meldung geschrieben werden soll.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> Gibt die Größe des globalen Speichers an, der von den Leistungsindikatoren freigegeben wird.Specifies the size of the global memory shared by performance counters.
<sharedListeners> Enthält Listener, auf die jedes Quell- oder Ablaufverfolgungselement verweisen kann.Contains listeners that any source or trace element can reference. Listener, die als freigegebene Listener identifiziert werden, können Quellen oder Ablauf Verfolgungen anhand des Namens hinzugefügt werden.Listeners identified as shared listeners can be added to sources or traces by name.
<sources> Gibt Ablauf Verfolgungs Quellen an, die Ablauf Verfolgungs Meldungen initiieren.Specifies trace sources that initiate tracing messages.
<switches> Enthält Ablauf Verfolgungs Schalter und die Ebenen, auf denen die Ablauf Verfolgungs Schalter festgelegt sind.Contains trace switches and the levels where the trace switches are set.
<trace> Enthält Listener, die Ablaufverfolgungsmeldungen sammeln, speichern und weiterleiten.Contains listeners that collect, store, and route tracing messages.

Übergeordnete ElementeParent Elements

ElementElement BESCHREIBUNGDescription
configuration Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.The root element in every configuration file used by the common language runtime and .NET Framework applications.

BeispielExample

Im folgenden Beispiel wird gezeigt, wie ein Ablauf Verfolgungs Schalter und ein Ablaufverfolgungslistener in das- <system.diagnostics> Element eingebettetThe following example shows how to embed a trace switch and a trace listener inside the <system.diagnostics> element. Der Ablauf General Verfolgungs Schalter ist auf die-Ebene festgelegt TraceLevel .The General trace switch is set to the TraceLevel level. Der Ablaufverfolgungslistener myListener erstellt eine Datei namens MyListener.log und schreibt die Ausgabe in die Datei.The trace listener myListener creates a file called MyListener.log and writes the output to the file.

Hinweis

In .NET Framework 2.0 können Sie Text verwenden, um den Wert eines Schalters anzugeben.In the .NET Framework version 2.0, you can use text to specify the value for a switch. Beispielsweise können Sie true für einen angeben BooleanSwitch oder den Text verwenden, der einen Enumerationswert wie z Error . b. für einen darstellt TraceSwitch .For example, you can specify true for a BooleanSwitch or use the text representing an enumeration value such as Error for a TraceSwitch. Die Zeile <add name="myTraceSwitch" value="Error" /> ist gleichbedeutend mit <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>  

Weitere InformationenSee also