<system.diagnostics> , element

Artykuł
05/10/2023

Określa odbiorniki śledzenia, które zbierają, przechowują i kierują komunikaty oraz poziom ustawiania przełącznika śledzenia.

<Konfiguracji>
<System.diagnostics>

Składnia

<system.diagnostics>
</system.diagnostics>

Atrybuty i elementy

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

Atrybuty

Brak.

Elementy podrzędne

Element	Opis
<Assert>	Określa, czy podczas wywoływania Debug.Assert metody ma być wyświetlane pole komunikatu; określa również nazwę pliku do zapisywania komunikatów.
<Performancecounters>	Określa rozmiar pamięci globalnej współużytkowanej przez liczniki wydajności.
<sharedListeners>	Zawiera odbiorniki, do których może się odwoływać dowolne źródło lub element śledzenia. Odbiorniki zidentyfikowane jako odbiorniki udostępnione można dodać do źródeł lub śladów według nazwy.
<sources>	Określa źródła śledzenia, które inicjują komunikaty śledzenia.
<Przełączniki>	Zawiera przełączniki śledzenia i poziomy, na których ustawiono przełączniki śledzenia.
<Śledzenia>	Zawiera odbiorniki, które zbierają, przechowują i śledzą komunikaty śledzenia tras.

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.

Przykład

W poniższym przykładzie pokazano, jak osadzić przełącznik śledzenia i odbiornik śledzenia wewnątrz <elementu system.diagnostics> . General Przełącznik śledzenia jest ustawiony na TraceLevel poziom. Odbiornik myListener śledzenia tworzy plik o nazwie MyListener.log i zapisuje dane wyjściowe w pliku.

Uwaga

W .NET Framework wersji 2.0 możesz użyć tekstu, aby określić wartość przełącznika. Można na przykład określić true dla BooleanSwitch elementu lub użyć tekstu reprezentującego wartość wyliczenia, taką jak Error dla elementu TraceSwitch. Linia <add name="myTraceSwitch" value="Error" /> jest równoważna .<add name="myTraceSwitch" value="1" />

<configuration>  
   <system.diagnostics>  
      <switches>  
         <add name="General" value="4" />  
      </switches>  
      <trace autoflush="true" indentsize="2">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Udostępnij za pośrednictwem