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

  • Článek

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

<Konfigurace>
  <System.diagnostics>
    <sources>
      <source>
        <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í.
sources Obsahuje zdroje trasování, které inicializuje trasování zpráv.
source Určuje zdroj trasování, který inicializuje 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 pro zdroj trasování.

Poznámky

Prvek <filter> musí být obsažen v elementu <add> pro naslouchací proces trasování zdroje, který určuje typ naslouchacího procesu, nejen název naslouchacího procesu definovaného ve <sdílenémListeners>. 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 procesu console v Listeners kolekci pro zdroj myTraceSourcetrasování , určení úrovně události filtru jako Error.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="myTraceSource" 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>

Viz také