Sdílet prostřednictvím

<trace> Element

Obsahuje naslouchací procesy, které shromažďují, ukládají a směrují trasovací zprávy.

<configuration><system.diagnostics><trace>

Syntaxe

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Attributes

Vlastnost Description
autoflush Volitelný atribut.

Určuje, jestli naslouchací procesy trasování automaticky vyprázdní výstupní vyrovnávací paměť po každé operaci zápisu.
indentsize Volitelný atribut.

Určuje počet mezer k odsazení.
useGlobalLock Volitelný atribut.

Určuje, jestli se má použít globální zámek.

autoflush – atribut

Hodnota Description
false Nevyprázdní výstupní vyrovnávací paměť automaticky. Toto je výchozí hodnota.
true Automaticky vyprázdní výstupní vyrovnávací paměť.

useGlobalLock – atribut

Hodnota Description
false Nepoužívá globální zámek, pokud je naslouchací proces bezpečný pro přístup z více vláken; v opačném případě použije globální zámek.
true Používá globální zámek bez ohledu na to, jestli je naslouchací proces bezpečný. Toto je výchozí hodnota.

Podřízené prvky

prvek Description
<posluchači> Určuje naslouchací proces, který shromažďuje, ukládá a směruje zprávy.

Nadřazené prvky

prvek Description
configuration Kořenový prvek v každém konfiguračním souboru, který je používán modulem Common Language Runtime (CLR) a aplikacemi rozhraní .NET Framework.
system.diagnostics Určuje naslouchací procesy trasování, které shromažďují, ukládají a směrují zprávy a úroveň nastavení přepínače trasování.

Example

Následující příklad ukazuje, jak pomocí <trace> elementu přidat naslouchací proces MyListener do Listeners kolekce. MyListener vytvoří soubor s názvem MyListener.log a zapíše výstup do souboru. Atribut useGlobalLock je nastaven na false, což způsobí, že globální zámek nebude použit, pokud je naslouchací proces trasování bezpečný podproces. Atribut autoflush je nastaven na true, což způsobí, že naslouchací proces trasování zapisovat do souboru bez ohledu na to, zda Trace.Flush je volána metoda. Atribut indentsize je nastaven na hodnotu 0 (nula), což způsobí, že naslouchací proces při zavolání metody odsadí nulové mezery Trace.Indent .

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

Viz také

  • Last updated on