Freigeben über

<trace>-Element

  • Artikel

Enthält Listener, die Verfolgungsmeldungen sammeln, speichern und weiterleiten.

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

<trace autoflush="true|false" 
       indentsize="indent value"/>

Attribute und Elemente

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

Attribute

Attribut Beschreibung

autoflush

Optionales Attribut.

Gibt an, ob die Ablaufverfolgungslistener den Ausgabepuffer nach jedem Schreibvorgang automatisch löschen.

indentsize

Optionales Attribut.

Gibt die Anzahl der Leerzeichen für den Einzug an.

Autoflush-Attribut

Wert Beschreibung

false

Der Ausgabepuffer wird nicht automatisch gelöscht. Dies ist der Standardwert.

true

Der Ausgabepuffer wird automatisch gelöscht.

Untergeordnete Elemente

Element Beschreibung

<listeners>

Gibt einen Listener an, der Meldungen sammelt, speichert und weiterleitet.

Übergeordnete Elemente

Element Beschreibung

configuration

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

system.diagnostics

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

Beispiel

Im folgenden Beispiel wird gezeigt, wie das <trace>-Element verwendet wird, um der Listeners-Auflistung den Listener MyListener hinzuzufügen. MyListener erstellt eine Datei mit der Bezeichnung MyListener.log und schreibt die Ausgabe in diese Datei. Für das autoflush-Attribut wird true festgelegt, wodurch der Ablaufverfolgungslistener unabhängig davon in die Datei schreibt, ob die Trace.Flush-Methode aufgerufen wurde oder nicht. Für das indentsize-Attribut wird 0 festgelegt, wodurch der Listener 0 Leerzeichen für den Einzug verwendet, wenn die Trace.Indent-Methode aufgerufen wird.

<configuration>
   <system.diagnostics>
      <trace autoflush="true" indentsize="0">
         <listeners>
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>

Siehe auch

Referenz

Schema für Ablaufverfolgungs- und Debugeinstellungen
TraceListener Class
DefaultTraceListener Class
TextWriterTraceListener Class
EventLogTraceListener Class