Поделиться через


EventProviderTraceListener Класс

Определение

Прослушиватель TraceSource записывает события в подсистему трассировки событий Windows.

public ref class EventProviderTraceListener : System::Diagnostics::TraceListener
public class EventProviderTraceListener : System.Diagnostics.TraceListener
type EventProviderTraceListener = class
    inherit TraceListener
Public Class EventProviderTraceListener
Inherits TraceListener
Наследование
EventProviderTraceListener

Примеры

private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B}");  

    EventProviderTraceListener listener = new EventProviderTraceListener(providerId.ToString(), "Test Listener", "::");  

    // You should use the All default level and control the level using the  
    // ETW session; otherwise, you may not log all the events requested by the  
    // session.  
    TraceSource source = new TraceSource("MyProvider", SourceLevels.All);  

    source.Listeners.Add(listener);  

    source.TraceData(TraceEventType.Warning | TraceEventType.Start, 2, new object[] { "abc", "def", true, 123 });  

    source.TraceEvent(TraceEventType.Warning, 12, "Provider guid: {0}", new object[] { providerId });  

    source.TraceInformation("string {0}, bool {1}, int {2}, ushort {3}", new object[] { "abc", false, 123, (UInt32)5 });  

Комментарии

Все данные события (трассировка или отладка) из исходного события записываются в подсистему ETW в виде строки. Элементы данных разделяются запятыми. Чтобы указать другой разделитель, используйте Delimiter свойство .

При добавлении прослушивателя в System.Diagnostics.TraceSource будет зарегистрирован поставщик в подсистеме ETW. Для записи событий в файл журнала необходимо создать сеанс трассировки событий Windows с помощью исполняемой программы Logman.exe (или чего-то подобного).

Манифест не требуется для получения событий из прослушивателя, так как данные события являются одной строкой.

При вызове System.Diagnostics.TraceSource методов для записи событий передается System.Diagnostics.TraceEventType значение перечисления. Перечисление содержит значения уровня и ключевого слова. При включении поставщика прослушивателя трассировки из сеанса трассировки событий Windows указанное значение уровня может быть значением, связанным с одним из следующих System.Diagnostics.TraceEventType значений перечисления:

  • Критический (значение равно 1)

  • Ошибка (значение 2)

  • Сведения (значение равно 8)

  • Подробный (значение равно 16)

  • Предупреждение (значение равно 4)

Значение ключевого слова, указанное для сеанса, может быть значением, связанным с одним из следующих System.Diagnostics.TraceEventType значений перечисления:

  • Resume (значение — 2048)

  • Start (значение — 256)

  • Stop (значение равно 512)

  • Suspend (значение — 1024)

  • Передача (значение — 4096)

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

EventProviderTraceListener(String)

Инициализирует новый экземпляр класса EventProviderTraceListener с помощью указанного идентификатора поставщика.

EventProviderTraceListener(String, String)

Инициализирует новый экземпляр класса EventProviderTraceListener с помощью указанного идентификатора поставщика и имени прослушивателя.

EventProviderTraceListener(String, String, String)

Инициализирует новый экземпляр класса EventProviderTraceListener с помощью указанного идентификатора поставщика, имени прослушивателя и разделителя.

Свойства

Attributes

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

(Унаследовано от TraceListener)
Delimiter

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

Filter

Получает или задает фильтр трассировки для прослушивателя трассировки.

(Унаследовано от TraceListener)
IndentLevel

Возвращает или задает уровень отступа.

(Унаследовано от TraceListener)
IndentSize

Возвращает или задает число пробелов в отступе.

(Унаследовано от TraceListener)
IsThreadSafe

Возвращает значение, указывающее, является ли прослушиватель трассировки потокобезопасным.

Name

Возвращает или задает имя для данного TraceListener.

(Унаследовано от TraceListener)
NeedIndent

Возвращает или задает значение, указывающее, нужен ли отступ в выходных данных.

(Унаследовано от TraceListener)
TraceOutputOptions

Возвращает или задает параметры выходных данных трассировки.

(Унаследовано от TraceListener)

Методы

Close()

Закрывает выходной поток, который больше не будет принимать выходные данные трассировки и отладки.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем TraceListener.

(Унаследовано от TraceListener)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом TraceListener, а при необходимости освобождает также управляемые ресурсы.

(Унаследовано от TraceListener)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Fail(String)

Посылает сообщение об ошибке в прослушиватель, создаваемый при реализации класса TraceListener.

(Унаследовано от 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.

(Унаследовано от TraceListener)
Write(Object, String)

Записывает имя категории и значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener.

(Унаследовано от TraceListener)
Write(String)

Если переопределено в производном классе, записывает заданное сообщение в прослушиватель, создаваемый в производном классе.

Write(String, String)

Записывает имя категории и сообщение в прослушиватель, создаваемый при реализации класса TraceListener.

(Унаследовано от TraceListener)
WriteIndent()

Записывает отступ в прослушиватель, создаваемый при реализации этого класса, и восстанавливает для свойства NeedIndent значение false.

(Унаследовано от TraceListener)
WriteLine(Object)

Записывает значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.

(Унаследовано от TraceListener)
WriteLine(Object, String)

Записывает имя категории и значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.

(Унаследовано от TraceListener)
WriteLine(String)

Если переопределено в производном классе, записывает сообщение, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый в производном классе.

WriteLine(String, String)

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

(Унаследовано от TraceListener)

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

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