Elemento <source>

Articolo
08/11/2011

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

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
name	Attributo facoltativo. Specifica il nome dell'origine di traccia.
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 traccia. 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	Elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Specifica listener di traccia 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 tracciatura.

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

Riferimenti

Schema delle impostazioni di traccia e debug

Concetti

Trace Sources

Opzioni di traccia

Condividi tramite