<trace> , element

  • Artykuł

Zawiera odbiorniki, które zbierają, przechowują i śledzą komunikaty śledzenia tras.

<Konfiguracji>
  <System.diagnostics>
    <Śledzenia>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut Opis
autoflush Atrybut opcjonalny.

Określa, czy odbiorniki śledzenia automatycznie opróżniają bufor wyjściowy po każdej operacji zapisu.
indentsize Atrybut opcjonalny.

Określa liczbę spacji do wcięcia.
useGlobalLock Atrybut opcjonalny.

Wskazuje, czy należy użyć blokady globalnej.

atrybut autoflush

Wartość Opis
false Nie opróżnia automatycznie buforu wyjściowego. Jest to opcja domyślna.
true Automatycznie opróżnia bufor wyjściowy.

useGlobalLock, atrybut

Wartość Opis
false Nie używa blokady globalnej, jeśli odbiornik jest bezpieczny wątkiem; w przeciwnym razie używa blokady globalnej.
true Używa blokady globalnej niezależnie od tego, czy odbiornik jest bezpieczny wątkiem. Jest to opcja domyślna.

Elementy podrzędne

Element Opis
<Słuchaczy> Określa odbiornik, który zbiera, przechowuje i kieruje komunikaty.

Elementy nadrzędne

Element Opis
configuration Element główny w każdym pliku konfiguracji używanym przez środowisko uruchomieniowe języka wspólnego i aplikacje programu .NET Framework.
system.diagnostics Określa odbiorniki śledzenia, które zbierają, przechowują i kierują komunikaty oraz poziom ustawiania przełącznika śledzenia.

Przykład

W poniższym przykładzie pokazano, jak za pomocą <trace> elementu dodać odbiornik MyListener do Listeners kolekcji. MyListener Tworzy plik o nazwie MyListener.log i zapisuje dane wyjściowe w pliku. Atrybut useGlobalLock jest ustawiony na falsewartość , co powoduje, że globalna blokada nie jest używana, jeśli odbiornik śledzenia jest bezpieczny wątkiem. Atrybut autoflush jest ustawiony na truewartość , co powoduje, że odbiornik śledzenia ma być zapisywany w pliku niezależnie od tego, czy Trace.Flush metoda jest wywoływana. Atrybut indentsize jest ustawiony na wartość 0 (zero), co powoduje, że odbiornik wcięł zero spacji po wywołaniu Trace.Indent metody.

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

Zobacz też