Delen via

<trace> Element

Bevat listeners die berichten verzamelen, opslaan en routeren.

<configuratie><system.diagnostics><trace>

Syntaxis

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

Attributes

Attribute Description
autoflush Optioneel kenmerk.

Hiermee geeft u op of de traceerlisteners de uitvoerbuffer automatisch leegmaken na elke schrijfbewerking.
indentsize Optioneel kenmerk.

Hiermee geeft u het aantal spaties op dat moet worden ingesprongen.
useGlobalLock Optioneel kenmerk.

Geeft aan of de globale vergrendeling moet worden gebruikt.

autoflush-kenmerk

Waarde Description
false De uitvoerbuffer wordt niet automatisch leeggemaakt. Dit is de standaardwaarde.
true Hiermee wordt de uitvoerbuffer automatisch leeggemaakt.

useGlobalLock Attribute

Waarde Description
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 standaardwaarde.

Kind-elementen

Onderdeel Description
<Luisteraars> Hiermee geeft u een listener op waarmee berichten worden verzameld, opgeslagen en gerouteerd.

Bovenliggende elementen

Onderdeel Description
configuration Het hoofdelement in elk configuratiebestand dat wordt gebruikt door de algemene taalruntime 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.

Example

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 traceerlist veilig is. Het autoflush kenmerk is ingesteld op true, waardoor de traceer-listener 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 inspringt 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>

Zie ook

  • Last updated on