<source> , element

Artykuł
05/10/2023

Określa źródło śledzenia, które inicjuje komunikaty śledzenia.

<Konfiguracji>
  <System.diagnostics>
    <sources>
      <Źródła>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	Opis
`name`	Atrybut opcjonalny. Określa nazwę źródła śledzenia.
`switchName`	Atrybut opcjonalny. Określa nazwę wystąpienia przełącznika śledzenia w aplikacji. Jeśli przełącznik nie jest identyfikowany w elemecie `<switches>` , wartość określa poziom przełącznika.
`switchType`	Atrybut opcjonalny. Określa typ przełącznika śledzenia. Jeśli istnieje, typ musi być prawidłową nazwą klasy i nie może być pustym ciągiem.
`extraAttribute`	Atrybut opcjonalny. Określa wartość atrybutu specyficznego dla źródła śledzenia zidentyfikowanego przez metodę GetSupportedAttributes dla tego źródła śledzenia.

Elementy podrzędne

Element	Opis
<Słuchaczy>	Zawiera odbiorniki, które zbierają, przechowują i kierują komunikaty.

Elementy nadrzędne

Element	Opis
`configuration`	Element główny w każdym pliku konfiguracji używanym przez środowisko uruchomieniowe języka wspólnego i aplikacje programu .NET Framework.
`system.diagnostics`	Określa odbiorniki śledzenia, które zbierają, przechowują i kierują komunikaty oraz poziom ustawiania przełącznika śledzenia.
`sources`	Zawiera źródła śledzenia, które inicjują komunikaty śledzenia.

Uwagi

Ten element może być używany w pliku konfiguracji maszyny (Machine.config) i pliku konfiguracji aplikacji.

Przykład

W poniższym przykładzie pokazano, jak za pomocą <source> elementu dodać źródło mySource śledzenia i ustawić poziom przełącznika źródłowego o nazwie sourceSwitch. Dodano odbiornik śledzenia konsoli, który zapisuje informacje śledzenia w konsoli programu .

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

Udostępnij przez