TraceListener TraceListener TraceListener TraceListener Class

Определение

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

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

Комментарии

Примеры реализации 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() TraceListener() TraceListener()

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

TraceListener(String) TraceListener(String) TraceListener(String) TraceListener(String)

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

Свойства

Attributes Attributes Attributes Attributes

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

Filter Filter Filter Filter

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

IndentLevel IndentLevel IndentLevel IndentLevel

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

IndentSize IndentSize IndentSize IndentSize

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

IsThreadSafe IsThreadSafe IsThreadSafe IsThreadSafe

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

Name Name Name Name

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

NeedIndent NeedIndent NeedIndent NeedIndent

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

TraceOutputOptions TraceOutputOptions TraceOutputOptions TraceOutputOptions

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

Методы

Close() Close() Close() Close()

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

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

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Fail(String) Fail(String) Fail(String) Fail(String)

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

Fail(String, String) Fail(String, String) Fail(String, String) 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() Flush() Flush() Flush()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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

(Inherited from MarshalByRefObject)
GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes()

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

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

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, 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[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) 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) TraceEvent(TraceEventCache, String, TraceEventType, Int32) TraceEvent(TraceEventCache, String, TraceEventType, Int32) TraceEvent(TraceEventCache, String, TraceEventType, Int32)

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

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) 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[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) 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) TraceTransfer(TraceEventCache, String, Int32, String, Guid) TraceTransfer(TraceEventCache, String, Int32, String, Guid) 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) Write(Object) Write(Object) 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) Write(Object, String) Write(Object, String) 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) Write(String) Write(String) Write(String)

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

Write(String, String) Write(String, String) Write(String, String) Write(String, String)

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

WriteIndent() WriteIndent() WriteIndent() 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) WriteLine(Object) WriteLine(Object) 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) WriteLine(Object, String) WriteLine(Object, String) 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) WriteLine(String) WriteLine(String) 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) WriteLine(String, String) WriteLine(String, String) 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.

Дополнительно