Elemento <source>

Articolo
09/12/2008

Aggiornamento: novembre 2007

Specifica un'origine di analisi che dà inizio ai messaggi di analisi.

Elemento <Configuration>
  Elemento <system.diagnostics>
    Elemento <sources>
      Elemento <source>

<source> 
  <listeners>...</listeners>
</source>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
name	Attributo facoltativo. Specifica il nome dell'origine di analisi.
switchName	Attributo facoltativo. Specifica il nome di un'istanza dell'opzione di traccia nell'applicazione. Se l'opzione non è identificata in un elemento <switches>, il valore indica il livello dell'opzione.
switchType	Attributo facoltativo. Specifica il tipo dell'opzione di analisi. Se presente, il tipo deve essere un nome di classe valido e non può essere costituito da una stringa vuota.
extraAttribute	Attributo facoltativo. Specifica il valore di un attributo specifico dell'origine di traccia identificato dal metodo GetSupportedAttributes per tale origine.

Elementi figlio

Elemento	Descrizione
Elemento <listeners> per <trace>	Contiene listener per la raccolta, l'archiviazione e l'invio di messaggi.

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	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.
sources	Contiene le origini di analisi che danno inizio ai messaggi di analisi.

Note

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

Esempio

Nell'esempio riportato di seguito viene illustrato l'utilizzo dell'elemento <source> per aggiungere l'origine di analisi mySource e impostare il livello per l'opzione di origine denominata sourceSwitch. Viene aggiunto un listener di analisi di console che consente di scrivere le informazioni di analisi sulla console.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="mySource" 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>

Vedere anche

Concetti

Origini di analisi

Opzioni di analisi

Riferimenti

Schema delle impostazioni di analisi e debug

Share via