<trace> – element

  • Článek

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

<Konfigurace>
  <System.diagnostics>
    <Trasování>

Syntax

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

Atributy a elementy

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

Atributy

Atribut Popis
autoflush Nepovinný atribut.

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

Určuje počet mezer, které se mají odsadit.
useGlobalLock Nepovinný atribut.

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

atribut autoflush

Hodnota Popis
false Nevyprázdní automaticky výstupní vyrovnávací paměť. Tato možnost je výchozí.
true Automaticky vyprázdní výstupní vyrovnávací paměť.

useGlobalLock – atribut

Hodnota Popis
false Nepoužívá globální zámek, pokud je naslouchací proces bezpečný 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ý z více vláken. Tato možnost je výchozí.

Podřízené elementy

Element Popis
<Posluchače> Určuje naslouchací proces, který shromažďuje, ukládá a směruje zprávy.

Nadřazené elementy

Element Popis
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í.

Příklad

Následující příklad ukazuje, jak použít <trace> element k přidání naslouchacího procesu 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 se nepoužije, pokud je naslouchací proces trasování bezpečný z více vláken. Atribut autoflush je nastaven na true, což způsobí, že trasovací naslouchací proces zapíše 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 Trace.Indent zavolání metody odsadí nulové mezery.

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