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

Articolo
09/12/2008

Aggiornamento: novembre 2007

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

Elemento <Configuration>
  Elemento <system.diagnostics>
    Elemento <sources>
      Elemento <source>
        Elemento <listeners> per <trace>
          Elemento <add> per <listeners> per <trace>
            Elemento <filter> per <add> per <listeners> per <source>

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

Attributi ed elementi

Nelle sezioni riportate di seguito 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	È l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Consente di specificare listener di analisi per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di analisi.
sources	Contiene le origini di analisi che danno inizio ai messaggi di analisi.
source	Specifica un'origine di analisi che dà inizio ai messaggi di analisi.
listeners	Contiene listener per la raccolta, l'archiviazione e l'invio di messaggi. I listener indirizzano l'output di analisi a una destinazione adatta.
add	Consente di aggiungere un listener all'insieme Listeners per un'origine di analisi.

Note

L'elemento <filter> deve essere incluso in un elemento <add> per un listener dell'origine di analisi 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 analisi 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>