<Elemento filter> per <l'aggiunta> di <listener> per <l'origine>

  • Articolo

Aggiunge un filtro a un listener nella raccolta Listeners per un'origine di traccia.

<Configurazione>
  <system.diagnostics>
    <sources>
      <source>
        <Ascoltatori>
          <add>
            <filter>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
type Attributo obbligatorio.

Specifica il tipo del filtro, che deve ereditare dalla TraceFilter classe . È possibile usare il nome completo dello spazio dei nomi del tipo, che corrisponde alla proprietà del FullName tipo oppure è possibile usare il nome completo del tipo, incluse le informazioni sull'assembly, che corrisponde alla AssemblyQualifiedName proprietà . Per informazioni sui nomi dei tipi completi, vedere Specifica di nomi di tipi completi.
initializeData Attributo facoltativo.

Stringa passata al costruttore per la classe di filtro specificata.

Elementi figlio

Nessuno.

Elementi padre

Elemento Descrizione
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics Specifica i listener di traccia per raccogliere, archiviare e indirizzare i messaggi, oltre al livello di impostazione di un'opzione di traccia.
sources Contiene le origini di traccia che avviano i messaggi di traccia.
source Specifica un'origine di traccia che avvia i messaggi di traccia.
listeners Contiene listener che raccolgono, archiviano e instradano i messaggi. I listener indirizzano l'output di traccia a una destinazione appropriata.
add Aggiunge un listener alla raccolta Listeners per un'origine di traccia.

Osservazioni:

L'elemento <filter> deve essere contenuto in un <add> elemento per un listener di origine di traccia che specifica il tipo del listener, non solo il nome di un listener definito in un <listener sharedListeners>. Se il listener è definito in un <oggetto sharedListeners>, il filtro per tale listener deve essere definito in tale elemento.

Questo elemento può essere usato nel file di configurazione del computer (Machine.config) e nel file di configurazione dell'applicazione.

Esempio

Nell'esempio seguente viene illustrato come usare l'elemento <filter> per aggiungere un filtro al listener console nella Listeners raccolta per l'origine myTraceSourcedi traccia, specificando il livello di evento del filtro come 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>

Vedi anche