Trace Класс

Определение

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

Наследование

Object

Trace

Примеры

В следующем примере используется Trace для указания начала и окончания выполнения программы. В примере также используются методы Trace.Indent и Trace.Unindent для различения выходных данных трассировки. Более полный пример использования см. Traceв разделе Практическое руководство. Добавление операторов трассировки в код приложения.

// Specify /DTRACE when compiling.

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;

int main()
{
   #if defined(TRACE)
   Trace::Listeners->Add( gcnew TextWriterTraceListener( Console::Out ) );
   Trace::AutoFlush = true;
   Trace::Indent();
   Trace::WriteLine( "Entering Main" );
   #endif
   Console::WriteLine( "Hello World." );
   #if defined(TRACE)
   Trace::WriteLine( "Exiting Main" );
   Trace::Unindent();
   #endif
   return 0;
}

// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Trace.AutoFlush = true;
       Trace.Indent();
       Trace.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Trace.WriteLine("Exiting Main");
       Trace.Unindent();
    }
}

' Specify /d:TRACE=True when compiling.

Imports System.Diagnostics

Class Test
    
    Shared Sub Main()
    
        Trace.Listeners.Add(New TextWriterTraceListener(Console.Out))
        Trace.AutoFlush = True
        Trace.Indent()
        Trace.WriteLine("Entering Main")
        Console.WriteLine("Hello World.")
        Trace.WriteLine("Exiting Main")
        Trace.Unindent()
        
    End Sub

End Class

Комментарии

Свойства и методы в Trace классе можно использовать для инструментирования сборок выпуска. Инструментирование позволяет отслеживать работоспособность приложения, работающего в реальных параметрах. Трассировка помогает изолировать проблемы и устранять их, не нарушая работу системы.

Этот класс предоставляет методы для отображения диалогового Assert окна и для выдачи утверждения, которое всегда Failбудет . Этот класс предоставляет методы записи в следующих вариантах:

• Write
• WriteLine
• WriteIf
• WriteLineIf

Классы BooleanSwitch и TraceSwitch предоставляют средства для динамического управления выходными данными трассировки. В платформа .NET Framework приложениях можно изменять значения этих параметров без перекомпиляции приложения. Сведения об использовании файла конфигурации для установки коммутатора в приложении платформа .NET Framework смSwitch. в разделе Класс и Практическое руководство. Create, инициализация и настройка параметров трассировки.

Вы можете настроить целевой объект выходных данных трассировки, добавив TraceListener экземпляры в коллекцию Listeners или удалив их из коллекции. Коллекция Listeners совместно используется классами Debug и Trace ; добавление прослушивателя трассировки в любой класс добавляет прослушиватель к обоим классам. По умолчанию выходные данные трассировки создаются с помощью DefaultTraceListener класса .

Класс Trace предоставляет свойства для получения или задания уровня и IndentSize, а также того, следует ли выполнять AutoFlush после каждой Indent записи.

В платформа .NET Framework приложениях можно задать AutoFlush и IndentSize дляTrace, изменив файл конфигурации, соответствующий имени приложения. Файл конфигурации должен быть отформатирован, как показано в следующем примере:

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="3" />  
  </system.diagnostics>  
</configuration>  

Атрибут ConditionalAttribute применяется к методам .Trace Компиляторы, поддерживающие ConditionalAttribute , игнорируют вызовы этих методов, если TRACE не определен как символ условной компиляции. Сведения о поддержке и синтаксисе для определения символа условной компиляции см. в документации ConditionalAttribute компилятора.

Чтобы определить символ условной TRACE компиляции в C#, добавьте /d:TRACE параметр в командную строку компилятора при компиляции кода с помощью командной строки или добавьте #define TRACE в начало файла. В Visual Basic добавьте параметр в /d:TRACE=True командную строку компилятора или добавьте #Const TRACE=True в файл .

ConditionalAttribute не поддерживается компилятором C++. Чтобы обеспечить эквивалентные функциональные возможности, необходимо заключить вызовы методов Trace в блок и добавить /DTRACE параметр в #if defined(TRACE) ... #endif командную строку компилятора или добавить #define TRACE в файл .

Свойства

Методы

События

Применяется к

Потокобезопасность

Данный тип потокобезопасен.

См. также раздел

• Debug
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute