<elemento source>

Articolo
05/10/2023

Specifica un'origine di traccia che avvia i messaggi di traccia.

<Configurazione>
  <system.diagnostics>
    <Fonti>
      <source>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
`name`	Attributo facoltativo. Specifica il nome dell'origine di traccia.
`switchName`	Attributo facoltativo. Specifica il nome di un'istanza del commutatore di traccia nell'applicazione. Se l'opzione non è identificata in un `<switches>` elemento, il valore specifica il livello per l'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 una stringa vuota.
`extraAttribute`	Attributo facoltativo. Specifica il valore per un attributo specifico dell'origine GetSupportedAttributes di traccia identificato dal metodo per tale origine di traccia.

Elementi figlio

Elemento	Descrizione
<Ascoltatori>	Contiene listener che raccolgono, archivia e instradano i messaggi.

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.
`sources`	Contiene le origini di traccia che avviano i messaggi di traccia.

Commenti

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 <source> per aggiungere l'origine mySource di traccia e impostare il livello per l'opzione di origine denominata sourceSwitch. Viene aggiunto un listener di traccia della console che scrive le informazioni di traccia nella 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>

Condividi tramite