<listeners> , element <śledzenia>

  • Artykuł

Określa odbiornik, który zbiera, przechowuje i kieruje komunikaty. Odbiorniki kierują dane wyjściowe śledzenia do odpowiedniego obiektu docelowego.

<Konfiguracji>
  <System.diagnostics>
    <Śledzenia>
      <Słuchaczy>

Składnia

<listeners>
  <add>...</add>  
  <clear/>  
  <remove ... />  
</listeners>

Atrybuty i elementy

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

Atrybuty

Brak.

Elementy podrzędne

Element Opis
<Dodaj> Dodaje odbiornik do kolekcji Listeners .
<Wyczyść> Czyści Listeners kolekcję na potrzeby śledzenia.
<Usunąć> Usuwa odbiornik z kolekcji Listeners .

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 element główny sekcji konfiguracji ASP.NET.
trace Zawiera odbiorniki, które zbierają, przechowują i śledzą komunikaty śledzenia tras.

Uwagi

Klasy Debug i Trace współdzielą tę samą kolekcję Odbiorniki . Jeśli dodasz obiekt odbiornika do kolekcji w jednej z tych klas, druga klasa używa tego samego odbiornika. Klasy odbiornika dostarczane z .NET Framework pochodzą z TraceListener klasy .

Plik konfiguracji

Ten element może być używany w pliku konfiguracji maszyny (Machine.config) i pliku konfiguracji aplikacji.

Przykład

W poniższym przykładzie pokazano, jak za pomocą <elementu odbiorników> dodać odbiorniki MyListener i MyEventListener do kolekcji Odbiorniki . MyListener Tworzy plik o nazwie MyListener.log i zapisuje dane wyjściowe w pliku. MyEventListener tworzy wpis w dzienniku zdarzeń.

<configuration>  
  <system.diagnostics>  
    <trace 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" />  
        <add name="MyEventListener"  
          type="System.Diagnostics.EventLogTraceListener,
            system, version=1.0.3300.0, Culture=neutral,
            PublicKeyToken=b77a5c561934e089"  
          initializeData="MyConfigEventLog"/>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

Zobacz też