<source>-Element

2023-05-26

Gibt eine Ablaufverfolgungsquelle an, die die Ablaufverfolgungsmeldungen initiiert.

<configuration>
   <system.diagnostics>
     <sources>
       <Quelle>

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

attribute	Beschreibung
`name`	Optionales Attribut. Gibt den Namen der Stapelüberwachungsquelle an.
`switchName`	Optionales Attribut. Gibt den Namen einer Stapelüberwachungsschalter-Instanz in der Anwendung an. Wenn der Schalter nicht in einem `<switches>`-Element identifiziert wird, gibt der Wert die Ebene für den Schalter an.
`switchType`	Optionales Attribut. Gibt den Typ des Stapelüberwachungsschalters an. Falls vorhanden, muss der Typ ein gültiger Klassenname sein und darf keine leere Zeichenfolge sein.
`extraAttribute`	Optionales Attribut. Gibt den Wert für ein quellenspezifisches Stapelüberwachungsattribut an, das von der GetSupportedAttributes-Methode für diese Stapelüberwachungsquelle identifiziert wird.

Untergeordnete Elemente

Element	BESCHREIBUNG
<listeners>	Enthält Listener, die Meldungen sammeln, speichern und weiterleiten.

Übergeordnete Elemente

Element	BESCHREIBUNG
`configuration`	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
`system.diagnostics`	Gibt Ablaufverfolgungslistener an, die Meldungen sammeln, speichern und weiterleiten sowie die Ebene, für die ein Ablaufverfolgungsschalter festgelegt ist.
`sources`	Enthält die Ablaufverfolgungsquellen, die die Ablaufverfolgungsmeldungen initiieren.

Bemerkungen

Dieses Element kann in der Computerkonfigurationsdatei (Machine.config) und in der Anwendungskonfigurationsdatei verwendet werden.

Beispiel

Das folgende Beispiel zeigt, wie Sie das <source>-Element verwenden, um die Ablaufverfolgungsquelle mySource hinzuzufügen und die Ebene für den Quellenschalter namens sourceSwitch festzulegen. Es wird ein Konsolen-Ablaufverfolgungslistener hinzugefügt, der Ablaufverfolgungsinformationen in die Konsole schreibt.

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

Freigeben über