Elemento <filter> per <add> per <listeners> per <trace>

Articolo
08/11/2011

Consente di aggiungere un filtro a un listener dell'insieme Listeners per una 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 analisi per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di traccia.
trace	Contiene listener per la raccolta, la memorizzazione e l'invio di 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.

Note

L'elemento <filter> deve essere incluso in un elemento <add> per un listener 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 la traccia, specificando Error come livello di evento per il filtro.

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