<filter> – element pro <přidání> pro naslouchací procesy> pro <<trasování>

  • Článek

Přidá filtr do naslouchacího Listeners procesu v kolekci pro trasování.

<Konfigurace>
  <System.diagnostics>
    <Trasování>
      <Posluchače>
        <add>
          <filter>

Syntaxe

<filter
  type="traceFilterClassName"
  initializeData="data" />

Atributy a prvky

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

Atributy

Atribut Popis
type Požadovaný atribut.

Určuje typ filtru, který by měl dědit z TraceFilter třídy. Můžete použít kvalifikovaný název oboru názvů typu, který odpovídá vlastnosti typu FullName , nebo můžete použít plně kvalifikovaný název typu včetně informací o sestavení, které odpovídají AssemblyQualifiedName vlastnosti. Informace o plně kvalifikovaných názvech typů naleznete v tématu Zadání plně kvalifikovaných názvů typů.
initializeData Nepovinný atribut.

Řetězec předaný konstruktoru pro zadanou třídu filtru.

Podřízené prvky

Nezaokrouhlovat.

Nadřazené prvky

Element (Prvek) 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í do vhodného cíle.
add Přidá do Listeners kolekce naslouchací proces.

Poznámky

Prvek <filter> musí být obsažen v elementu <add> pro naslouchací proces trasování, který určuje typ naslouchacího procesu, nejen název naslouchacího procesu definovaného ve <sharedListeners>. Pokud je naslouchací proces definován v <sharedListeners>, musí být v daném prvku definován filtr pro tento naslouchací proces.

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

Příklad

Následující příklad ukazuje, jak pomocí <filter> elementu přidat filtr do naslouchacího Listeners procesu console v kolekci pro trasování a určit úroveň události filtru jako Error.

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

Viz také