Condividi tramite


<source> Elemento

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

<configurazione>
   <system.diagnostics>
     <Fonti>
       <fonte>

Sintassi

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

Attributi ed elementi

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

Attributes

Attribute Description
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 di un attributo specifico dell'origine di traccia identificato dal GetSupportedAttributes metodo per tale origine di traccia.

Elementi figli

Elemento Description
<Ascoltatori> Contiene listener che raccolgono, archiviano e instradano i messaggi.

Elementi padre

Elemento Description
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 che raccolgono, archiviano e instradano i messaggi e il livello in cui è impostata un'opzione di traccia.
sources Contiene origini di traccia che avviano i messaggi di traccia.

Osservazioni:

Questo elemento può essere usato nel file di configurazione del computer (Machine.config) e nel file di configurazione dell'applicazione.

Example

Nell'esempio seguente viene illustrato come usare l'elemento per aggiungere l'origine <source>mySource di traccia e per 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>

Vedere anche