TraceListener Класс

Определение

Предоставляет abstract базовый класс для прослушивателей, осуществляющих мониторинг вывода трассировочной и отладочной информации.Provides the abstract base class for the listeners who monitor trace and debug output.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public ref class TraceListener abstract : IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
public abstract class TraceListener : IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
type TraceListener = class
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TraceListener
Implements IDisposable
Наследование
TraceListener
Наследование
TraceListener
Производный
Реализации

Комментарии

Примеры реализации TraceListener класса см. в разделе DefaultTraceListener TextWriterTraceListener EventLogTraceListener классы и.For examples of how to implement a TraceListener, see the DefaultTraceListener, TextWriterTraceListener and the EventLogTraceListener classes.

Для использования прослушивателя трассировки необходимо включить трассировку или отладку.You must enable tracing or debugging to use a trace listener. Ниже приведен синтаксис, характерный для компилятора.The following syntax is compiler specific. Если используются компиляторы, отличные от C# или Visual Basic, обратитесь к документации по компилятору.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • Чтобы включить отладку в C#, добавьте /d:DEBUG флаг в командную строку компилятора при компиляции кода или добавьте #define DEBUG в начало файла.To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. В Visual Basic добавьте /d:DEBUG=True флаг в командную строку компилятора.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • Чтобы включить трассировку в C#, добавьте /d:TRACE флаг в командную строку компилятора при компиляции кода или добавьте #define TRACE в начало файла.To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. В Visual Basic добавьте /d:TRACE=True флаг в командную строку компилятора.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

Чтобы добавить прослушиватель трассировки, измените файл конфигурации, соответствующий имени приложения.To add a trace listener, edit the configuration file that corresponds to the name of your application. В этом файле можно добавить прослушиватель, задать его тип и задать его параметр, удалить прослушиватель или удалить все прослушиватели, заданные приложением ранее.Within this file, you can add a listener, set its type and set its parameter, remove a listener, or clear all the listeners previously set by the application. Файл конфигурации следует отформатировать, как показано в следующем примере.The configuration file should be formatted similar to the following example.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Дополнительные сведения об использовании файлов конфигурации для трассировки см. в разделе < System. > Diagnostics.For more information on using configuration files for tracing, see <system.diagnostics>.

Примечания для тех, кто реализует этот метод

Наследуйте этот класс, чтобы реализовать пользовательский прослушиватель для Debug Trace классов и.Inherit from this class to implement a custom listener for the Debug and Trace classes. Как минимум необходимо реализовать Write(String) WriteLine(String) методы и.At a minimum, you must implement the Write(String) and WriteLine(String) methods. Кроме того, можно реализовать Fail(String) Close() Flush() методы и.Additionally, you can implement the Fail(String), Close() and Flush() methods.

Конструкторы

TraceListener()

Инициализирует новый экземпляр класса TraceListener.Initializes a new instance of the TraceListener class.

TraceListener(String)

Инициализирует новый экземпляр класса TraceListener с использованием заданного имени в качестве прослушивателя.Initializes a new instance of the TraceListener class using the specified name as the listener.

Свойства

Attributes

Возвращает настраиваемые атрибуты прослушивателя трассировки, определенные в файле конфигурации приложения.Gets the custom trace listener attributes defined in the application configuration file.

Filter

Получает или задает фильтр трассировки для прослушивателя трассировки.Gets or sets the trace filter for the trace listener.

IndentLevel

Возвращает или задает уровень отступа.Gets or sets the indent level.

IndentSize

Возвращает или задает число пробелов в отступе.Gets or sets the number of spaces in an indent.

IsThreadSafe

Возвращает значение, указывающее, является ли прослушиватель трассировки потокобезопасным.Gets a value indicating whether the trace listener is thread safe.

Name

Возвращает или задает имя для данного TraceListener.Gets or sets a name for this TraceListener.

NeedIndent

Возвращает или задает значение, указывающее, нужен ли отступ в выходных данных.Gets or sets a value indicating whether to indent the output.

TraceOutputOptions

Возвращает или задает параметры выходных данных трассировки.Gets or sets the trace output options.

Методы

Close()

Если переопределено в производном классе, закрывает выходной поток, который, таким образом, больше не принимает выходные данные трассировки и отладки.When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем TraceListener.Releases all resources used by the TraceListener.

Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом TraceListener, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Fail(String)

Посылает сообщение об ошибке в прослушиватель, создаваемый при реализации класса TraceListener.Emits an error message to the listener you create when you implement the TraceListener class.

Fail(String, String)

Выдает простое и подробное сообщение об ошибке в прослушиватель, создаваемый при реализации класса TraceListener.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

Flush()

Если переопределено в производном классе, очищает выходной буфер.When overridden in a derived class, flushes the output buffer.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetSupportedAttributes()

Возвращает настраиваемые атрибуты, поддерживаемые прослушивателем трассировки.Gets the custom attributes supported by the trace listener.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Записывает сведения трассировки, объект данных и сведения о событиях в специальные выходные данные прослушивателя.Writes trace information, a data object and event information to the listener specific output.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Записывает сведения трассировки, массив объектов данных и сведения о событии в специальные выходные данные прослушивателя.Writes trace information, an array of data objects and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Записывает сведения трассировки и сведения о событиях в специальные выходные данные прослушивателя.Writes trace and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Записывает сведения трассировки, сообщение и сведения о событиях в специальные выходные данные прослушивателя.Writes trace information, a message, and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Записывает сведения трассировки, форматированный массив объектов данных и сведения о событиях в специальные выходные данные прослушивателя.Writes trace information, a formatted array of objects and event information to the listener specific output.

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Записывает сведения трассировки, сообщение, идентификатор сопутствующего действия и сведения о событиях в специальные выходные данные прослушивателя.Writes trace information, a message, a related activity identity and event information to the listener specific output.

Write(Object)

Записывает значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

Write(Object, String)

Записывает имя категории и значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

Write(String)

Если переопределено в производном классе, записывает заданное сообщение в прослушиватель, создаваемый в производном классе.When overridden in a derived class, writes the specified message to the listener you create in the derived class.

Write(String, String)

Записывает имя категории и сообщение в прослушиватель, создаваемый при реализации класса TraceListener.Writes a category name and a message to the listener you create when you implement the TraceListener class.

WriteIndent()

Записывает отступ в прослушиватель, создаваемый при реализации этого класса, и восстанавливает для свойства NeedIndent значение false.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

WriteLine(Object)

Записывает значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

WriteLine(Object, String)

Записывает имя категории и значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

WriteLine(String)

Если переопределено в производном классе, записывает сообщение, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый в производном классе.When overridden in a derived class, writes a message to the listener you create in the derived class, followed by a line terminator.

WriteLine(String, String)

Записывает имя категории и сообщение, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

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

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

Данный тип потокобезопасен.This type is thread safe.

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