<source>-Element

Artikel
08/10/2011

Gibt eine Ablaufverfolgungsquelle an, die Ablaufverfolgungsmeldungen initiiert.

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

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
name	Optionales Attribut. Gibt den Namen der Ablaufverfolgungsquelle an.
switchName	Optionales Attribut. Gibt den Namen einer Ablaufverfolgungsschalter-Instanz in der Anwendung an. Wenn der Schalter in einem <switches>-Element nicht bezeichnet ist, wird die Schalterebene durch den Wert angegeben.
switchType	Optionales Attribut. Gibt den Typ des Ablaufverfolgungsschalters an. Wenn das Attribut angegeben ist, muss der Typ ein gültiger Klassenname sein und darf keine leere Zeichenfolge sein.
extraAttribute	Optionales Attribut. Gibt den Wert eines für die Ablaufverfolgungsquelle spezifischen Attributs an, das von der GetSupportedAttributes-Methode für diese Ablaufverfolgungsquelle ermittelt wird.

Untergeordnete Elemente

Element	Beschreibung
<listeners>-Element für <trace>	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 die Ablaufverfolgungslistener, die Meldungen sammeln, speichern und weiterleiten, sowie die Ebene an, auf der ein Ablaufverfolgungsschalter festgelegt wird.
sources	Enthält Ablaufverfolgungsquellen, die Ablaufverfolgungsmeldungen initiieren.

Hinweise

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die Ablaufverfolgungsquelle mySource mithilfe des <source> -Elements hinzugefügt wird und wie die Ebene für den Quellenschalter mit der Bezeichnung sourceSwitch festgelegt wird. Außerdem wird ein Ablaufverfolgungslistener für eine Konsole hinzugefügt, der Ablaufverfolgungsinformationen an die Konsole ausgibt.

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