Elemento <source>

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