<clear> , element dla <odbiorników> na potrzeby <śledzenia>

Artykuł
05/10/2023

Czyści Listeners kolekcję na potrzeby śledzenia.

<Konfiguracji>
  <System.diagnostics>
    <Śledzenia>
      <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.
`trace`	Zawiera odbiorniki, które zbierają, przechowują i śledzą komunikaty śledzenia tras.
`listeners`	Zawiera odbiorniki, które zbierają, przechowują i kierują komunikaty. Odbiorniki kierują dane wyjściowe śledzenia do odpowiedniego obiektu docelowego.

Uwagi

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

Kolekcję można wyczyścić Listeners programowo, wywołując metodę Clear Trace.Listeners we właściwości (System.Diagnostics.Trace.Listeners.Clear()).

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

Uwaga

Element <clear> usuwa element DefaultTraceListener z Listeners kolekcji, zmieniając zachowanie Debug.Assertmetod , Trace.Assert, Debug.Faili Trace.Fail . Assert Wywołanie metody lub Fail zwykle powoduje wyświetlenie pola komunikatu. Jednak pole komunikatu nie jest wyświetlane, jeśli DefaultTraceListener element nie znajduje się w kolekcji Listeners .

Przykład

W poniższym przykładzie pokazano, jak używać elementu przed użyciem <clear><add> elementu w celu dodania odbiornika console do Listeners kolekcji na potrzeby śledzenia.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <clear/>  
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >  
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />  
        </add>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

Udostępnij za pośrednictwem