<källelement>

Artikel
04/08/2023

Anger en spårningskälla som initierar spårningsmeddelanden.

<Konfiguration>
  <system.diagnostics>
    <Källor>
      <Källkod>

Syntax

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

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Attribut	Beskrivning
`name`	Valfritt attribut. Anger namnet på spårningskällan.
`switchName`	Valfritt attribut. Anger namnet på en spårningsväxelinstans i programmet. Om växeln inte identifieras i ett `<switches>` element anger värdet nivån för växeln.
`switchType`	Valfritt attribut. Anger typ av spårningsväxel. Om den finns måste typen vara ett giltigt klassnamn och får inte vara en tom sträng.
`extraAttribute`	Valfritt attribut. Anger värdet för ett spårningskällaspecifikt attribut som identifieras av metoden för den GetSupportedAttributes spårningskällan.

Underordnade element

Element	Beskrivning
<Lyssnare>	Innehåller lyssnare som samlar in, lagrar och dirigerar meddelanden.

Överordnade element

Element	Beskrivning
`configuration`	Rotelementet i varje konfigurationsfil som används av den vanliga språkkörningen och .NET Framework program.
`system.diagnostics`	Anger spårningslyssnare som samlar in, lagrar och dirigerar meddelanden och den nivå där en spårningsväxel har angetts.
`sources`	Innehåller spårningskällor som initierar spårningsmeddelanden.

Kommentarer

Det här elementet kan användas i datorkonfigurationsfilen (Machine.config) och programkonfigurationsfilen.

Exempel

I följande exempel visas hur du använder -elementet <source> för att lägga till spårningskällan mySource och för att ange nivån för källväxeln med namnet sourceSwitch. En konsolspårningslyssnare läggs till som skriver spårningsinformation till konsolen.

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

Dela via