Elemento <filter> per <add> per <listeners> per <source>

Articolo
08/11/2011

Consente di aggiungere un filtro a un listener dell'insieme Listeners per un'origine di traccia.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
type	Attributo obbligatorio. Specifica il tipo di filtro, che deve ereditare dalla classe TraceFilter. È possibile utilizzare solo il nome completo dello spazio dei nomi del tipo, che corrisponde alla proprietà FullName del tipo, oppure il nome completo del tipo incluse le informazioni sull'assembly, che corrisponde alla proprietà AssemblyQualifiedName. Per informazioni sui nomi completi dei tipi, vedere Specifica di nomi di tipo completi.
initializeData	Attributo facoltativo. Stringa passata al costruttore per la classe di filtro specificata.

type

Attributo obbligatorio.

Specifica il tipo di filtro, che deve ereditare dalla classe TraceFilter. È possibile utilizzare solo il nome completo dello spazio dei nomi del tipo, che corrisponde alla proprietà FullName del tipo, oppure il nome completo del tipo incluse le informazioni sull'assembly, che corrisponde alla proprietà AssemblyQualifiedName. Per informazioni sui nomi completi dei tipi, vedere Specifica di nomi di tipo 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 utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Specifica listener di traccia per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di traccia.
sources	Contiene le origini di traccia che danno inizio ai messaggi di tracciatura.
source	Specifica un'origine di tracciatura che dà inizio ai messaggi di tracciatura.
listeners	Contiene listener per la raccolta, l'archiviazione e l'invio di messaggi. I listener indirizzano l'output di tracciatura a una destinazione adatta.
add	Consente di aggiungere un listener all'insieme Listeners per un'origine di traccia.

Note

L'elemento <filter> deve essere incluso in un elemento <add> per un listener dell'origine di traccia che specifica il tipo del listener e non solo il nome di un listener definito in un Elemento <sharedListeners>. Se il listener viene definito in un Elemento <sharedListeners>, è necessario definire il filtro per il listener in tale elemento.

È possibile utilizzare questo elemento nei file di configurazione del computer (Machine.config) e dell'applicazione.

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare l'elemento <filter> per aggiungere un filtro al listener console nell'insieme Listeners per l'origine di traccia myTraceSource, specificando Error come livello di evento per il filtro.

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