<System.Diagnostics > элемент<system.diagnostics> Element

Задает прослушиватели трассировки, собирающие, хранящие и маршрутизирующие сообщения, а также уровень, на котором установлен ключ трассировки.Specifies trace listeners that collect, store, and route messages and the level where a trace switch is set.

<configuration><configuration>
<system.diagnostics><system.diagnostics>

СинтаксисSyntax

<system.diagnostics>   
</system.diagnostics>  

Атрибуты и элементыAttributes and Elements

В следующих разделах описаны атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

Отсутствует.None.

Дочерние элементыChild Elements

ЭлементElement ОписаниеDescription
<assert><assert> Определяет, должно ли выводиться окно сообщения при вызове метода Debug.Assert. Кроме того, задает имя файла, в который записываются сообщения.Specifies whether to display a message box when you call the Debug.Assert method; also specifies the name of the file to write messages to.
<performanceCounters><performanceCounters> Задает размер глобальной памяти, совместно используемой счетчиками производительности.Specifies the size of the global memory shared by performance counters.
<sharedListeners><sharedListeners> Содержит прослушиватели, на которые может ссылаться любой источник или элемент трассировки.Contains listeners that any source or trace element can reference. Прослушиватели, определенные как общие могут добавляться к источникам и трассировки по имени.Listeners identified as shared listeners can be added to sources or traces by name.
<sources><sources> Задает источники трассировки, которые инициируют сообщения трассировки.Specifies trace sources that initiate tracing messages.
<switches><switches> Содержит переключатели трассировки и уровни, где они установлены.Contains trace switches and the levels where the trace switches are set.
<trace><trace> Содержит прослушиватели, которые собирают, хранят и маршрутизируют сообщения трассировки.Contains listeners that collect, store, and route tracing messages.

Родительские элементыParent Elements

ЭлементElement ОписаниеDescription
configuration Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.

ПримерExample

В следующем примере показано, как внедрение переключателя трассировки и прослушивателя трассировки в <system.diagnostics > элемент.The following example shows how to embed a trace switch and a trace listener inside the <system.diagnostics> element. General Установлен переключатель трассировки TraceLevel уровень.The General trace switch is set to the TraceLevel level. Прослушиватель трассировки myListener создается файл с именем MyListener.log и записывает выходные данные в файл.The trace listener myListener creates a file called MyListener.log and writes the output to the file.

Примечание

В .NET Framework версии 2.0 для указания значения переключателя можно использовать текст.In the .NET Framework version 2.0, you can use text to specify the value for a switch. Например, можно указать true для BooleanSwitch или текст, представляющий значение перечисления, таких как Error для TraceSwitch.For example, you can specify true for a BooleanSwitch or use the text representing an enumeration value such as Error for a TraceSwitch. Строка <add name="myTraceSwitch" value="Error" /> эквивалентна <add name="myTraceSwitch" value="1" />.The line <add name="myTraceSwitch" value="Error" /> is equivalent to <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>  

См. такжеSee also