TraceListener Класс

Определение

Пространство имен:: System.Diagnostics

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет базовый класс для прослушивателей, отслеживающих выходные abstract данные трассировки и отладки.

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

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

MarshalByRefObject
TraceListener

Производный: Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

Подробнее…

Реализации: IDisposable

Необходимо включить трассировку или отладку для использования прослушивателя трассировки. Следующий синтаксис является определенным компилятором. Если вы используете компиляторы, отличные от C# или Visual Basic, обратитесь к документации для компилятора.

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

Чтобы добавить прослушиватель трассировки, измените файл конфигурации, соответствующий имени приложения. В этом файле можно добавить прослушиватель, задать тип и задать его параметр, удалить прослушиватель или очистить все прослушиватели, заданные приложением ранее. Файл конфигурации должен быть отформатирован следующим образом.

<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>.

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

Наследуется от этого класса для реализации пользовательского прослушивателя для Debug и Trace классов. Как минимум, необходимо реализовать Write(String) методы и WriteLine(String) методы. Кроме того, можно реализовать Fail(String)Close() методы и Flush() методы.

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

Имя	Описание
TraceListener()	Инициализирует новый экземпляр класса TraceListener.
TraceListener(String)	Инициализирует новый экземпляр TraceListener класса, используя указанное имя в качестве прослушивателя.

Свойства

Имя	Описание
Attributes	Возвращает атрибуты пользовательского прослушивателя трассировки, определенные в файле конфигурации приложения.
Filter	Возвращает или задает фильтр трассировки для прослушивателя трассировки.
IndentLevel	Возвращает или задает уровень отступа.
IndentSize	Возвращает или задает количество пробелов в отступе.
IsThreadSafe	Возвращает значение, указывающее, является ли прослушиватель трассировки потокобезопасной.
Name	Возвращает или задает имя для этого TraceListener.
NeedIndent	Возвращает или задает значение, указывающее, следует ли отступить выходные данные.
TraceOutputOptions	Возвращает или задает параметры выходных данных трассировки.

Методы

Имя	Описание
Close()	При переопределении в производном классе закрывает выходной поток, чтобы он больше не получал трассировку или отладку выходных данных.
CreateObjRef(Type)	Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, используемые параметром TraceListener.
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые TraceListener и при необходимости освобождает управляемые ресурсы.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Fail(String, String)	Выдает сообщение об ошибке и подробное сообщение об ошибке прослушивателю, создаваемому TraceListener при реализации класса.
Fail(String)	Выдает сообщение об ошибке прослушивателю, создаваемому при реализации TraceListener класса.
Flush()	При переопределении в производном классе очищает выходной буфер.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
GetSupportedAttributes()	Возвращает настраиваемые атрибуты, поддерживаемые прослушивателем трассировки.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Записывает сведения трассировки, объект данных и сведения о событии в конкретный выход прослушивателя.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Записывает сведения трассировки, массив объектов данных и сведений о событиях в конкретный выходной объект прослушивателя.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Записывает сведения трассировки, форматированный массив объектов и сведений о событиях в конкретный выходной объект прослушивателя.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Записывает сведения трассировки, сообщение и сведения о событии в конкретный выход прослушивателя.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Записывает данные трассировки и события в конкретный выход прослушивателя.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Записывает сведения трассировки, сообщение, связанное удостоверение действия и сведения о событиях прослушивателя в определенные выходные данные прослушивателя.
Write(Object, String)	Записывает имя категории и значение метода объекта ToString() в прослушиватель, который вы создаете при реализации TraceListener класса.
Write(Object)	Записывает значение метода объекта ToString() в прослушиватель, который вы создаете при реализации TraceListener класса.
Write(String, String)	Записывает имя категории и сообщение прослушивателя, создаваемого TraceListener при реализации класса.
Write(String)	При переопределении в производном классе записывает указанное сообщение в прослушиватель, который создается в производном классе.
WriteIndent()	Записывает отступ в прослушиватель, который вы создаете при реализации этого класса, и сбрасывает свойство NeedIndentв `false` .
WriteLine(Object, String)	Записывает имя категории и значение метода объекта ToString() в прослушиватель, который вы создаете при реализации TraceListener класса, за которым следует терминатор строки.
WriteLine(Object)	Записывает значение метода объекта ToString() в прослушиватель, который создается при реализации TraceListener класса, за которым следует терминатор строки.
WriteLine(String, String)	Записывает имя категории и сообщение прослушивателю, созданному при реализации TraceListener класса, за которым следует терминатор строки.
WriteLine(String)	При переопределении в производном классе записывает сообщение прослушивателю, созданному в производном классе, за которым следует терминатор строки.

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

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

Этот тип является потокобезопасной.

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

Обратная связь

Были ли сведения на этой странице полезными?