<element clear> pro <naslouchací procesy> pro <trasování>

  • Článek

Vymaže kolekci Listeners pro trasování.

<Konfigurace>
  <System.diagnostics>
    <Trasování>
      <Posluchače>
        <Jasné>

Syntax

<clear/>

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Žádné

Podřízené elementy

Žádné

Nadřazené elementy

Element Popis
configuration Kořenový prvek v každém konfiguračním souboru, který je používán modulem Common Language Runtime (CLR) a aplikacemi rozhraní .NET Framework.
system.diagnostics Určuje naslouchací procesy trasování, které shromažďují, ukládají a směrují zprávy, a úroveň nastavení přepínače trasování.
trace Obsahuje naslouchací procesy, které shromažďují, ukládají a směrují trasovací zprávy.
listeners Obsahuje naslouchací procesy, které shromažďují, ukládají a směrují zprávy. Naslouchací procesy směrují výstup trasování na příslušný cíl.

Poznámky

Element <clear> odebere všechny naslouchací procesy z Listeners kolekce pro trasování. Před použitím <add> elementu <clear> můžete použít element, abyste měli jistotu, že v kolekci nejsou žádné další aktivní naslouchací procesy.

Kolekci Listeners můžete programově vymazat voláním Clear metody ve Trace.Listeners vlastnosti (System.Diagnostics.Trace.Listeners.Clear()).

Tento prvek lze použít v konfiguračním souboru počítače (Machine.config) a konfiguračním souboru aplikace.

Poznámka

Element <clear> odebere DefaultTraceListener z Listeners kolekce a změní chování Debug.Assertmetod , Trace.Assert, Debug.Faila Trace.Fail . Volání metody Assert nebo Fail obvykle vede k zobrazení pole se zprávou. Pokud však pole DefaultTraceListener se zprávou není v kolekci, nezobrazí se Listeners .

Příklad

Následující příklad ukazuje, jak použít <clear> element před použitím elementu <add> k přidání naslouchacího procesu console do Listeners kolekce pro trasování.

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

Viz také