EventAttribute Classe

Definição

Namespace:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Origem:

EventSource.cs

Especifica informações de esquema de evento adicionais para um evento.

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

Herança

Object

Attribute

EventAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir mostra como usar a EventAttribute classe para definir uma variedade de eventos. Este exemplo de código faz parte de um exemplo maior fornecido para a EventSource classe .

[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

Comentários

Ao aplicar esse atributo a um método de evento ETW definido em uma EventSourceclasse derivada de , você deve chamar o WriteEvent método na classe base, passando a ID do evento, seguido pelos mesmos argumentos que o método definido é passado. Você deve seguir o padrão mostrado nos exemplos a seguir.

Construtores

EventAttribute(Int32)

Inicializa uma nova instância da classe EventAttribute com o identificador de eventos especificado.

Propriedades

ActivityOptions	Especifica o comportamento dos eventos de início e parada de uma atividade. Uma atividade é a região de tempo em um aplicativo entre o início e a parada.
Channel	Obtém ou define um log de eventos adicional no qual o evento deve ser gravado.
EventId	Obtém ou define o identificador do evento.
Keywords	Obtém ou define as palavras-chave para o evento.
Level	Obtém ou define o nível do evento.
Message	Obtém ou define a mensagem para o evento.
Opcode	Obtém ou define o código de operação para o evento.
Tags	Obtém ou define o valor EventTags deste objeto EventAttribute. Uma marca de evento é um valor definido pelo usuário que é passado quando o evento é registrado.
Task	Obtém ou define a tarefa para o evento.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)
Version	Obtém ou define a versão do evento.

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)