EventAttribute Класс

Определение

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

System.Diagnostics.Tracing

Сборка:

System.Diagnostics.Tracing.dll

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

EventSource.cs

Задает дополнительную информацию схемы для события.

public ref class EventAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class EventAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
type EventAttribute = class
    inherit Attribute

Public NotInheritable Class EventAttribute
Inherits Attribute

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

Object

Attribute

EventAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере показано, как использовать класс для EventAttribute определения различных событий. Этот пример входит в состав более крупного примера использования класса EventSource.

[Event(1, Message = "Application Failure: {0}", Level = EventLevel.Error, Keywords = Keywords.Diagnostic)]
public void Failure(string message) { WriteEvent(1, message); }

<[Event](1, Message:="Application Failure: {0}", Level:=EventLevel.Error, Keywords:=Keywords.Diagnostic)> _
Public Sub Failure(ByVal message As String)
    WriteEvent(1, message)
End Sub

[Event(2, Message = "Starting up.", Keywords = Keywords.Perf, Level = EventLevel.Informational)]
public void Startup() { WriteEvent(2); }

<[Event](2, Message:="Starting up.", Keywords:=Keywords.Perf, Level:=EventLevel.Informational)> _
Public Sub Startup()
    WriteEvent(2)
End Sub

[Event(3, Message = "loading page {1} activityID={0}", Opcode = EventOpcode.Start,
    Task = Tasks.Page, Keywords = Keywords.Page, Level = EventLevel.Informational)]
public void PageStart(int ID, string url) { if (IsEnabled()) WriteEvent(3, ID, url); }

<[Event](3, Message:="loading page {1} activityID={0}", Opcode:=EventOpcode.Start, Task:=Tasks.Page, Keywords:=Keywords.Page, Level:=EventLevel.Informational)> _
Public Sub PageStart(ByVal ID As Integer, ByVal url As String)
    If IsEnabled() Then
        WriteEvent(3, ID, url)
    End If
End Sub

[Event(4, Opcode = EventOpcode.Stop, Task = Tasks.Page, Keywords = Keywords.Page, Level = EventLevel.Informational)]
public void PageStop(int ID) { if (IsEnabled()) WriteEvent(4, ID); }

<[Event](4, Opcode:=EventOpcode.Stop, Task:=Tasks.Page, Keywords:=Keywords.Page, Level:=EventLevel.Informational)> _
Public Sub PageStop(ByVal ID As Integer)
    If IsEnabled() Then
        WriteEvent(4, ID)
    End If
End Sub

Комментарии

При применении этого атрибута к методу события ETW, определенному в производном EventSourceот класса, необходимо вызвать WriteEvent метод в базовом классе, передав идентификатор события, а затем те же аргументы, что и определенный метод. Следует следовать шаблону, показанной в следующих примерах.

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

EventAttribute(Int32)

Инициализирует новый экземпляр класса EventAttribute с указанным идентификатором события.

Свойства

ActivityOptions	Задает поведение событий запуска и остановки действия. Действие — это область времени между запуском и остановкой приложения.
Channel	Возвращает или задает дополнительный журнал событий, в который должно быть записано событие.
EventId	Возвращает или задает идентификатор события.
Keywords	Возвращает или задает ключевые слова для события.
Level	Возвращает или задает уровень для события.
Message	Возвращает или задает сообщение для события.
Opcode	Возвращает или задает код операции для события.
Tags	Получает или задает значение EventTags для этого объекта EventAttribute. Тег события является определяемым пользователем значением, которое передается при регистрации события в журнале.
Task	Возвращает или задает задачу для события.
TypeId	В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)
Version	Возвращает или задает версию события.

Методы

Equals(Object)	Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)