EventProviderTraceListener Класс

Ссылка

Определение

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

Сборка:: System.Core.dll

Важно!

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

Прослушиватель 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

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

MarshalByRefObject

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)

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

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

TraceListener

Бөлісу құралы: