DelimitedListTraceListener Класс

Определение

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

System.Diagnostics

Сборка:

System.Diagnostics.TextWriterTraceListener.dll

Исходный код:

DelimitedListTraceListener.cs

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

public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListener

public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener

type DelimitedListTraceListener = class
    inherit TextWriterTraceListener

Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener

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

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

DelimitedListTraceListener

Комментарии

Выходные данные трассировки отображаются в текстовом формате с разделителями, в котором используется разделитель, заданный свойством Delimiter . Разделитель используется для завершения каждого поля в строке вывода. Например, чтобы отобразить выходные данные трассировки в электронной таблице Microsoft Excel, можно указать запятую (",") в качестве разделителя и создать csv-файл с разделителями-запятыми.

Важно!

Этот тип реализует интерфейс IDisposable. По окончании использования выдаленную ему память следует прямо или косвенно освободить. Чтобы удалить тип напрямую, вызовите его Dispose метод в блокеtry/catch . Чтобы сделать это косвенно, используйте языковые конструкции, такие как using (в C#) или Using (в Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в статье об интерфейсе IDisposable.

Вы можете создать в коде DelimitedListTraceListener . Кроме того, только в платформа .NET Framework приложениях можно включить или отключить DelimitedListTraceListener с помощью файла конфигурации приложения, а затем использовать настроенный DelimitedListTraceListener в приложении.

Примечание

Разделяет DelimitedListTraceListener только текст, который создается с помощью методов, имена которых начинаются со слова Trace, например DelimitedListTraceListener.TraceEvent или Trace.TraceWarning. Данные трассировки, создаваемые с помощью Debug.Write методов и TextWriterTraceListener.WriteLine , не разделяются.

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

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="delimitedListener"   
          type="System.Diagnostics.DelimitedListTraceListener"   
          delimiter=","   
          initializeData="delimitedOutput.csv"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Примечание

При попытке выполнить запись в файл, который используется или недоступен, имя файла автоматически добавляется в виде guid.

Примечание

Прослушиватели предназначены для использования методами Debugклассов , Traceи TraceSource для записи сведений трассировки. Методы прослушивателя, за исключением конструкторов, не должны вызываться непосредственно из кода приложения.

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

DelimitedListTraceListener(Stream)	Инициализирует новый экземпляр класса DelimitedListTraceListener, с помощью которого осуществляется запись в указанный исходящий поток.
DelimitedListTraceListener(Stream, String)	Инициализирует новый экземпляр класса DelimitedListTraceListener, с помощью которого осуществляется запись в заданный исходящий поток и который имеет указанное имя.
DelimitedListTraceListener(String)	Инициализирует новый экземпляр класса DelimitedListTraceListener с помощью которого осуществляется запись в указанный файл.
DelimitedListTraceListener(String, String)	Инициализирует новый экземпляр класса DelimitedListTraceListener, с помощью которого осуществляется запись в заданный файл и который имеет указанное имя.
DelimitedListTraceListener(TextWriter)	Инициализирует новый экземпляр класса DelimitedListTraceListener, с помощью которого осуществляется запись в указанный модуль записи текста.
DelimitedListTraceListener(TextWriter, String)	Инициализирует новый экземпляр класса DelimitedListTraceListener, с помощью которого осуществляется запись в заданный модуль записи текста и который имеет указанное имя.

Свойства

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

Методы

Close()	Закрывает свойство Writer, которое, таким образом, больше не получает выходные данные отладки или трассировки. (Унаследовано от TextWriterTraceListener)
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, занятые модулем TraceListener. (Унаследовано от TraceListener)
Dispose(Boolean)	Удаляет этот объект TextWriterTraceListener. (Унаследовано от TextWriterTraceListener)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Fail(String)	Посылает сообщение об ошибке в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
Fail(String, String)	Выдает простое и подробное сообщение об ошибке в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
Flush()	Очищает выходной буфер для свойства Writer. (Унаследовано от TextWriterTraceListener)
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)	Записывает сведения трассировки и сведения о событиях в специальные выходные данные прослушивателя. (Унаследовано от TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Записывает сведения трассировки, сообщение и сведения о событии в исходящий файл или поток.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Записывает сведения трассировки, форматированный массив объектов данных и сведения о событии в исходящий файл или поток.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Записывает сведения трассировки, сообщение, идентификатор сопутствующего действия и сведения о событиях в специальные выходные данные прослушивателя. (Унаследовано от TraceListener)
Write(Object)	Записывает значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
Write(Object, String)	Записывает имя категории и значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
Write(String)	Записывает сообщение в свойство Writer данного экземпляра. (Унаследовано от TextWriterTraceListener)
Write(String, String)	Записывает имя категории и сообщение в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
WriteIndent()	Записывает отступ в прослушиватель, создаваемый при реализации этого класса, и восстанавливает для свойства NeedIndent значение false. (Унаследовано от TraceListener)
WriteLine(Object)	Записывает значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
WriteLine(Object, String)	Записывает имя категории и значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
WriteLine(String)	Записывает сообщение в свойство Writer данного экземпляра, за которым следует ограничитель строки. Ограничитель строки по умолчанию — возврат каретки, за которым следует перевод строки (\r\n). (Унаследовано от TextWriterTraceListener)
WriteLine(String, String)	Записывает имя категории и сообщение, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)