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

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di aggiungere un filtro a un listener dell'insieme sharedListeners.

Elemento <Configuration>
  Elemento <system.diagnostics>
    Elemento <sharedListeners>
      Elemento <add> per <sharedListeners>
        Elemento <filter> per <add> per <sharedListeners>

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

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. È possibile utilizzare solo il nome completo del tipo nel formato della proprietà Type.FullName oppure il nome completo del tipo incluse le informazioni sull'assembly nel formato della proprietà Type.AssemblyQualifiedName. Per informazioni sulla creazione di un nome di tipo completo, vedere Specifica di nomi di tipo completi.
initializeData	Attributo facoltativo. Stringa passata al costruttore per la classe specificata.

type

Attributo obbligatorio.

Specifica il tipo di filtro. È possibile utilizzare solo il nome completo del tipo nel formato della proprietà Type.FullName oppure il nome completo del tipo incluse le informazioni sull'assembly nel formato della proprietà Type.AssemblyQualifiedName. Per informazioni sulla creazione di un nome di tipo completo, vedere Specifica di nomi di tipo completi.

initializeData

Attributo facoltativo.

Stringa passata al costruttore per la classe specificata.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	Elemento principale 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 analisi.
sharedListeners	Insieme di listener cui può fare riferimento qualsiasi elemento di origine o di analisi.
add	Consente di aggiungere un listener all'insieme sharedListeners.

Note

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

È 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 di analisi console nell'insieme sharedListeners.

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