DelimitedListTraceListener Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Направляет выходные данные трассировки или отладки в модуль записи текста, такой как модуль записи в поток или в поток, такой как файловый поток.
public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListenerpublic class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListenertype DelimitedListTraceListener = class
inherit TextWriterTraceListenerPublic Class DelimitedListTraceListener
Inherits TextWriterTraceListener- Наследование
- Наследование
Комментарии
Выходные данные трассировки отображаются в текстовом формате с разделителями, в котором используется разделитель, заданный свойством 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() |
Возвращает атрибут пользовательского файла конфигурации, поддерживаемый прослушивателем трассировки с разделителями. |
| GetSupportedAttributes() |
Возвращает настраиваемые атрибуты, поддерживаемые прослушивателем трассировки. (Унаследовано от TraceListener) |
| 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 значение |
| WriteLine(Object) |
Записывает значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener) |
| WriteLine(Object, String) |
Записывает имя категории и значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener) |
| WriteLine(String) |
Записывает сообщение в свойство Writer данного экземпляра, за которым следует ограничитель строки. Ограничитель строки по умолчанию — возврат каретки, за которым следует перевод строки (\r\n). (Унаследовано от TextWriterTraceListener) |
| WriteLine(String, String) |
Записывает имя категории и сообщение, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener) |
