DelimitedListTraceListener Класс

Определение

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

System.Diagnostics

Сборки:

netstandard.dll, 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.

Замечание

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

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

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

Свойства

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

Методы

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