TraceListener Класс

Ссылка

Определение

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

Сборка:: System.Diagnostics.TraceSource.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

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

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

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

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

MarshalByRefObject
TraceListener

Наследование: Object
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)	Посылает сообщение об ошибке в прослушиватель, создаваемый при реализации класса TraceListener.
Fail(String, 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)	Записывает сведения трассировки и сведения о событиях в специальные выходные данные прослушивателя.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Записывает сведения трассировки, сообщение и сведения о событиях в специальные выходные данные прослушивателя.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Записывает сведения трассировки, форматированный массив объектов данных и сведения о событиях в специальные выходные данные прослушивателя.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Записывает сведения трассировки, сообщение, идентификатор сопутствующего действия и сведения о событиях в специальные выходные данные прослушивателя.
Write(Object)	Записывает значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener.
Write(Object, String)	Записывает имя категории и значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener.
Write(String)	Если переопределено в производном классе, записывает заданное сообщение в прослушиватель, создаваемый в производном классе.
Write(String, String)	Записывает имя категории и сообщение в прослушиватель, создаваемый при реализации класса TraceListener.
WriteIndent()	Записывает отступ в прослушиватель, создаваемый при реализации этого класса, и восстанавливает для свойства NeedIndent значение `false`.
WriteLine(Object)	Записывает значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.
WriteLine(Object, String)	Записывает имя категории и значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.
WriteLine(String)	Если переопределено в производном классе, записывает сообщение, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый в производном классе.
WriteLine(String, String)	Записывает имя категории и сообщение, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.

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

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

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