<traceringselement>

Artikel
04/08/2023

Bevat listeners die traceringsberichten verzamelen, opslaan en routeren.

<configuratie>
<system.diagnostics>
<Trace>

Syntax

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

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk	Beschrijving
`autoflush`	Optioneel kenmerk. Hiermee geeft u op of de traceringslisteners de uitvoerbuffer automatisch leegmaken na elke schrijfbewerking.
`indentsize`	Optioneel kenmerk. Hiermee geeft u het aantal spaties dat moet worden ingesprongen.
`useGlobalLock`	Optioneel kenmerk. Hiermee wordt aangegeven of de globale vergrendeling moet worden gebruikt.

autoflush-kenmerk

Waarde	Beschrijving
`false`	De uitvoerbuffer wordt niet automatisch leeggemaakt. Dit is de standaardinstelling.
`true`	De uitvoerbuffer wordt automatisch leeggemaakt.

useGlobalLock-kenmerk

Waarde	Beschrijving
`false`	Maakt geen gebruik van de globale vergrendeling als de listener thread-veilig is; anders wordt de globale vergrendeling gebruikt.
`true`	Maakt gebruik van de globale vergrendeling, ongeacht of de listener thread-veilig is. Dit is de standaardinstelling.

Onderliggende elementen

Element	Beschrijving
<Luisteraars>	Hiermee geeft u een listener waarmee berichten worden verzameld, opgeslagen en doorgestuurd.

Bovenliggende elementen

Element	Beschrijving
`configuration`	Het hoofdelement in elk configuratiebestand dat wordt gebruikt door de common language runtime en .NET Framework toepassingen.
`system.diagnostics`	Hiermee geeft u traceerlisteners op die berichten verzamelen, opslaan en routeren en het niveau waarop een traceringsswitch is ingesteld.

Voorbeeld

In het volgende voorbeeld ziet u hoe u het <trace> -element gebruikt om de listener MyListener toe te voegen aan de Listeners verzameling. MyListener maakt een bestand met de naam MyListener.log en schrijft de uitvoer naar het bestand. Het useGlobalLock kenmerk is ingesteld op false, waardoor de globale vergrendeling niet wordt gebruikt als de traceringslistener thread-veilig is. Het autoflush kenmerk is ingesteld op true, waardoor de traceringslistener naar het bestand schrijft, ongeacht of de Trace.Flush methode wordt aangeroepen. Het indentsize kenmerk is ingesteld op 0 (nul), waardoor de listener nul spaties laat inspringen wanneer de Trace.Indent methode wordt aangeroepen.

<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>

Delen via