<trace> Elem

Olyan figyelőket tartalmaz, amelyek nyomkövetési üzeneteket gyűjtenek, tárolnak és irányítanak.

<configuration>   <system.diagnostics>     <trace>

Szemantika

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

Attribútumok és elemek

A következő szakaszok az attribútumokat, a gyermekelemeket és a szülőelemeket ismertetik.

Attributes

Attribute Description
autoflush Nem kötelező attribútum.

Megadja, hogy a nyomkövetési figyelők minden írási művelet után automatikusan kiürítik-e a kimeneti puffert.
indentsize Nem kötelező attribútum.

Megadja a behúzandó szóközök számát.
useGlobalLock Nem kötelező attribútum.

Azt jelzi, hogy a globális zárolást használni kell-e.

autoflush attribútum

Érték Description
false Nem üríti ki automatikusan a kimeneti puffert. Ez az alapértelmezett érték.
true Automatikusan kiüríti a kimeneti puffert.

useGlobalLock attribútum

Érték Description
false Nem használja a globális zárolást, ha a figyelő szálbiztos; ellenkező esetben a globális zárolást használja.
true A globális zárolást használja, függetlenül attól, hogy a figyelő szálbiztos-e. Ez az alapértelmezett érték.

Gyermekelemek

Elem Description
<Hallgatók> Olyan figyelőt ad meg, amely üzeneteket gyűjt, tárol és irányít.

Szülőelemek

Elem Description
configuration A közös nyelvi futtatókörnyezet és .NET-keretrendszer alkalmazások által használt összes konfigurációs fájl gyökéreleme.
system.diagnostics Meghatározza az üzeneteket gyűjtő, tároló és átirányító nyomkövetési figyelőket, valamint azt a szintet, ahol a nyomkövetési kapcsoló be van állítva.

Example

Az alábbi példa bemutatja, hogyan adhat hozzá figyelőt <trace> a gyűjteményhez MyListener az Listeners elem használatával. MyListener létrehoz egy elnevezett MyListener.log fájlt, és a kimenetet a fájlba írja. Az useGlobalLock attribútum a következőre falsevan állítva, ami miatt a globális zárolás nem használható, ha a nyomkövetési figyelő szálbiztos. Az autoflush attribútum a következőre truevan állítva, ami miatt a nyomkövetési figyelő a fájlba ír, függetlenül attól, hogy a Trace.Flush metódus meghívva van-e. Az indentsize attribútum értéke 0 (nulla), ezért a figyelő nulla szóközt húz be a Trace.Indent metódus meghívásakor.

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

Lásd még

  • Last updated on