<trace>-Element

Artikel
06/05/2023

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

<configuration>
<system.diagnostics>
<trace>

Syntax

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

Attribute und Elemente

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

Attribute

attribute	Beschreibung
`autoflush`	Optionales Attribut. Gibt an, ob die Ablaufverfolgungslistener den Ausgabepuffer nach jedem Schreibvorgang automatisch leeren.
`indentsize`	Optionales Attribut. Die Anzahl der Leerzeichen für den Einzug.
`useGlobalLock`	Optionales Attribut. Gibt an, ob die globale Sperre verwendet werden soll.

autoflush-Attribut

Wert	BESCHREIBUNG
`false`	Leert den Ausgabepuffer nicht automatisch. Dies ist die Standardeinstellung.
`true`	Leert den Ausgabepuffer automatisch.

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 Nachrichten 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 Ablaufverfolgungslistener an, die Meldungen sammeln, speichern und weiterleiten sowie die Ebene, für die ein Ablaufverfolgungsschalter festgelegt ist.

Beispiel

Das folgende Beispiel zeigt, wie Sie das <trace>-Element verwenden, um den Listener MyListener der Listeners-Sammlung hinzuzufügen. MyListener erstellt eine Datei namens MyListener.log und schreibt die Ausgabe in die Datei. Das useGlobalLock-Attribut ist auf false festgelegt, wodurch die globale Sperre nicht verwendet wird, wenn der Ablaufverfolgungslistener threadsicher ist. Das autoflush-Attribut ist auf true festgelegt, wodurch der Ablaufverfolgungslistener unabhängig davon, ob die Methode aufgerufen wird, in die Trace.Flush-Datei schreibt. Das indentsize-Attribut ist auf 0 (null) festgelegt, wodurch der Listener null Leerzeichen einrückt, 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>

Freigeben über