<system.diagnostics>-Element

Artikel
08/20/2008

Aktualisiert: November 2007

Gibt die Ablaufverfolgungslistener, die Meldungen sammeln, speichern und weiterleiten, sowie die Ebene an, auf der ein Ablaufverfolgungsschalter festgelegt wird.

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

<system.diagnostics> 
</system.diagnostics>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Element	Beschreibung
<assert>	Legt fest, ob ein Meldungsfeld angezeigt wird, wenn die Debug.Assert-Methode aufgerufen wird; gibt darüber hinaus den Namen der Datei an, in die Meldungen geschrieben werden.
<performanceCounters>	Gibt die Größe des globalen Speichers an, der von den Leistungsindikatoren gemeinsam genutzt wird.
<sharedListeners>	Enthält Listener, auf die jedes source- bzw. trace-Element verweisen kann. Listener, die als freigegeben gekennzeichnet sind, können anhand des Namens zu Quellen oder Ablaufverfolgungen hinzugefügt werden.
<sources>	Gibt Ablaufverfolgungsquellen an, die Ablaufverfolgungsmeldungen initiieren.
<switches>	Enthält Ablaufverfolgungsschalter und die Ebenen, auf die die Ablaufverfolgungsschalter festgelegt werden.
<trace>	Enthält Listener, die Verfolgungsmeldungen sammeln, speichern und weiterleiten.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

Beispiel

Im folgenden Beispiel wird gezeigt, wie ein Ablaufverfolgungsschalter und ein Ablaufverfolgungslistener in das <system.diagnostics>-Element eingebettet werden. Der Ablaufverfolgungsschalter General wird auf die Ebene TraceLevel.Error festgelegt. Der Ablaufverfolgungslistener myListener erstellt eine Datei mit der Bezeichnung MyListener.log und schreibt die Ausgabe in die Datei.

Tipp

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

Referenz

Schema für Ablaufverfolgungs- und Debugeinstellungen

Trace

Debug

Freigeben über