<clear> , element dla <odbiorników> dla <źródła>

Artykuł
05/10/2023

Czyści Listeners kolekcję dla źródła śledzenia.

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

Składnia

<clear/>

Atrybuty i elementy

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

Atrybuty

Brak.

Elementy podrzędne

Brak.

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.
`listeners`	Określa odbiorniki, które zbierają, przechowują i kierują komunikaty.

Uwagi

Element <clear> usuwa wszystkie odbiorniki z Listeners kolekcji dla źródła śledzenia, w tym DefaultTraceListener. Element można użyć przed użyciem <clear><add> elementu, aby mieć pewność, że w kolekcji nie ma żadnych innych aktywnych odbiorników.

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 używać elementu przed użyciem <clear><add> elementów w celu dodania odbiorników console i textListener do Listeners kolekcji dla źródła TraceSourceAppśledzenia .

<configuration>  
  <system.diagnostics>  
    <sources>  
       <source name="TraceSourceApp" switchName="sourceSwitch"
         switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <clear/>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="textListener"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="myListener.log"/>  
    </sharedListeners>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Udostępnij przez