<Elemento filter> per <add> per <sharedListeners>

  • Articolo

Aggiunge un filtro a un listener nella raccolta sharedListeners.

<Configurazione>
  <system.diagnostics>
    <sharedListeners>
      <add>
        <filter>

Sintassi

<filter type="System.Diagnostics.EventTypeFilter"
  initializeData="Warning" />

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. È possibile utilizzare solo il nome completo del tipo (nel formato della Type.FullName proprietà) oppure usare il nome completo del tipo, incluse le informazioni sull'assembly (nel formato della Type.AssemblyQualifiedName proprietà). Per informazioni sulla creazione di un nome di tipo completo, vedere Specifica di nomi di tipi completi.
Initializedata Attributo facoltativo.

Stringa passata al costruttore per la classe 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.
sharedListeners Raccolta di listener a cui può fare riferimento qualsiasi elemento di origine o traccia.
add Aggiunge un listener all'insieme sharedListeners .

Osservazioni:

Se un listener viene definito in un <add> elemento dell'elemento <sharedListeners> , il filtro per tale listener deve essere definito in un <filter> elemento figlio dell'elemento <add> .

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 di traccia nella sharedListeners raccolta.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="myTraceSource" >  
        <listeners>  
          <add name="console" />  
          <remove name="Default" />  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="console"
        type="System.Diagnostics.ConsoleTraceListener" >  
        <filter type="System.Diagnostics.EventTypeFilter"
          initializeData="Error" />  
      </add>  
    </sharedListeners>  
  </system.diagnostics>  
</configuration>

Vedi anche