<trace-element>

Artikel
04/08/2023

Innehåller lyssnare som samlar in, lagrar och dirigerar spårningsmeddelanden.

<Konfiguration>
<system.diagnostics>
<Spåra>

Syntax

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

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Attribut	Beskrivning
`autoflush`	Valfritt attribut. Anger om spårningslyssnare automatiskt tömer utdatabufferten efter varje skrivåtgärd.
`indentsize`	Valfritt attribut. Anger antalet blanksteg som ska dras in.
`useGlobalLock`	Valfritt attribut. Anger om det globala låset ska användas.

autoflush-attribut

Värde	Beskrivning
`false`	Tömer inte utdatabufferten automatiskt. Det här är standardinställningen.
`true`	Tömer utdatabufferten automatiskt.

useGlobalLock-attribut

Värde	Beskrivning
`false`	Använder inte det globala låset om lyssnaren är trådsäker. annars används det globala låset.
`true`	Använder det globala låset oavsett om lyssnaren är trådsäker. Det här är standardinställningen.

Underordnade element

Element	Beskrivning
<Lyssnare>	Anger en lyssnare som samlar in, lagrar och dirigerar meddelanden.

Överordnade element

Element	Beskrivning
`configuration`	Rotelementet i varje konfigurationsfil som används av common language runtime och .NET Framework program.
`system.diagnostics`	Anger spårningslyssnare som samlar in, lagrar och dirigerar meddelanden och nivån där en spårningsväxel anges.

Exempel

I följande exempel visas hur du använder elementet <trace> för att lägga till lyssnaren MyListener i Listeners samlingen. MyListener skapar en fil med namnet MyListener.log och skriver utdata till filen. Attributet useGlobalLock är inställt på false, vilket gör att det globala låset inte används om spårningslyssnaren är trådsäker. Attributet autoflush är inställt på true, vilket gör att spårningslyssnaren skriver till filen oavsett om Trace.Flush metoden anropas. Attributet indentsize är inställt på 0 (noll), vilket gör att lyssnaren drar in noll blanksteg när Trace.Indent metoden anropas.

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

Dela via