Teilen über

<source> Element

Gibt eine Ablaufverfolgungsquelle an, die Ablaufverfolgungsmeldungen initiiert.

<configuration>
  <system.diagnostics>
    <sources>
      <source>

Syntax

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

Attribute und Elemente

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

Attribute

Merkmal Description
name Optionales Attribut.

Gibt den Namen der Ablaufverfolgungsquelle an.
switchName Optionales Attribut.

Gibt den Namen einer Ablaufverfolgungsswitchinstanz in der Anwendung an. Wenn der Schalter in einem <switches> Element nicht identifiziert wird, gibt der Wert die Ebene für den Schalter an.
switchType Optionales Attribut.

Gibt den Typ des Ablaufverfolgungsschalters an. Wenn vorhanden, muss der Typ ein gültiger Klassenname sein und darf keine leere Zeichenfolge sein.
extraAttribute Optionales Attribut.

Gibt den Wert für ein attributspezifisches Ablaufverfolgungselement an, das von der Methode für diese GetSupportedAttributes Ablaufverfolgungsquelle identifiziert wird.

Untergeordnete Elemente

Element Description
<Hörer> Enthält Listener, die Nachrichten sammeln, speichern und weiterleiten.

Übergeordnete Elemente

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

Bemerkungen

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

Example

Das folgende Beispiel zeigt, wie Sie das <source> Element verwenden, um die Ablaufverfolgungsquelle mySource hinzuzufügen und die Ebene für den Quellswitch namens sourceSwitchfestzulegen. Ein Konsolenablaufverfolgungslistener wird 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>

Siehe auch

  • Last updated on