Share via

<listeners>, element źródła <>

  • Artykuł

Dodaje lub usuwa odbiorniki w kolekcji Listeners dla elementu TraceSource. Odbiornik kieruje dane wyjściowe śledzenia do odpowiedniego obiektu docelowego, takiego jak dziennik, okno lub plik tekstowy.

<Konfiguracji>
  <System.diagnostics>
    <sources>
      <Źródła>
        <Słuchaczy>

Składnia

<listeners>
  <add>...</add>  
  <remove ... />  
  <clear/>  
</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 .
<Usunąć> Usuwa odbiornik z kolekcji Listeners .
<Wyczyść> Czyści Listeners kolekcję dla źródła śledzenia.

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.
sources Zawiera źródła śledzenia, które inicjują komunikaty śledzenia.
source Określa źródło śledzenia, które inicjuje komunikaty śledzenia.

Uwagi

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ą <listeners> elementu dodać odbiornik śledzenia konsoli do mySource źródła i usunąć domyślny odbiornik śledzenia.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="mySource" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener">  
            <filter type="System.Diagnostics.EventTypeFilter"
              initializeData="Error"/>  
          </add>  
          <remove name="Default"/>  
        </listeners>  
      </source>  
    </sources>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Zobacz też