Freigeben über


<system.diagnostics>-Element

Gibt Ablaufverfolgungslistener an, die Meldungen sammeln, speichern und weiterleiten sowie die Ebene, für die ein Ablaufverfolgungsschalter festgelegt ist.

<configuration>
  <system.diagnostics>

Syntax

<system.diagnostics>
</system.diagnostics>  

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Keine

Untergeordnete Elemente

Element BESCHREIBUNG
<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.
<performanceCounters> Gibt die Größe des globalen Speichers an, der von den Leistungsindikatoren freigegeben wird.
<sharedListeners> Enthält Listener, auf die jedes Quell- oder Ablaufverfolgungselement verweisen kann. Listener, die als freigegebene Listener festgelegt wurden, können Quellen oder Stapelüberwachungen anhand ihres Namens hinzugefügt werden.
<sources> Gibt die Überwachungsquellen an, die die Überwachungsmeldungen initiieren.
<switches> Enthält Überwachungsschalter und die Ebenen, auf denen diese Schalter festgelegt werden.
<trace> Enthält Listener, die Ablaufverfolgungsmeldungen sammeln, speichern und weiterleiten.

Übergeordnete Elemente

Element BESCHREIBUNG
configuration Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.

Beispiel

Das folgende Beispiel zeigt, wie Sie einen Überwachungsschalter und einen Überwachungslistener in das <system.diagnostics>-Element einbetten. Der Überwachungsschalter General ist auf die Ebene TraceLevel festgelegt. Der Überwachungslistener myListener erstellt eine Datei namens MyListener.log und schreibt die Ausgabe in die Datei.

Hinweis

In .NET Framework 2.0 können Sie Text verwenden, um den Wert eines Schalters anzugeben. Sie können beispielsweise true für einen BooleanSwitch angeben oder den Text verwenden, der einem Enumerationswert entspricht, z. B. Error für einen TraceSwitch. Die Zeile <add name="myTraceSwitch" value="Error" /> ist gleichbedeutend mit <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>  

Siehe auch