<trace>-Element

Artikel
08/10/2011

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

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

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.
useGlobalLock	Optionales Attribut. Gibt an, ob die globale Sperre verwendet werden soll.

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.

useGlobalLock

Optionales Attribut.

Gibt an, ob die globale Sperre verwendet werden soll.

autoflush-Attribut

Wert	Beschreibung
false	Der Ausgabepuffer wird nicht automatisch gelöscht. Dies ist der Standardwert.
true	Der Ausgabepuffer wird automatisch gelöscht.

useGlobalLock-Attribut

Wert	Beschreibung
false	Verwendet die globale Sperre nicht, wenn der Listener threadsicher ist; verwendet andernfalls die globale Sperre.
true	Verwendet die globale Sperre unabhängig davon, ob der Listener threadsicher ist. Dies ist die Standardeinstellung.

Untergeordnete Elemente

Element	Beschreibung
<listeners>	Gibt einen Listener an, der Meldungen sammelt, speichert und weiterleitet.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
system.diagnostics	Gibt die Ablaufverfolgungslistener, die Meldungen sammeln, speichern und weiterleiten, sowie die Ebene an, auf der ein Ablaufverfolgungsschalter festgelegt wird.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie der Listeners-Auflistung mithilfe des <trace>-Elements der MyListener-Listener hinzugefügt wird. MyListener erstellt eine Datei mit der Bezeichnung MyListener.log und schreibt die Ausgabe in die Datei. Das useGlobalLock-Attribut wird auf false festgelegt, wodurch die globale Sperre nicht verwendet wird, wenn der Ablaufverfolgungslistener threadsicher ist. 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 (null) festgelegt, wodurch der Listener 0 Leerzeichen für den Einzug verwendet, wenn die Trace.Indent-Methode aufgerufen wird.

<configuration>
   <system.diagnostics>
      <trace useGlobalLock="false" 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>