EventAttribute Clase

Referencia

Definición

Espacio de nombres:: System.Diagnostics.Tracing

Ensamblado:: System.Diagnostics.Tracing.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Source:: EventSource.cs

Source:: EventSource.cs

Source:: EventSource.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Especifica información adicional del esquema de eventos para un 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

Herencia: Object

Attribute
EventAttribute

Atributos: AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo usar la EventAttribute clase para definir una variedad de eventos. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase 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

Comentarios

Al aplicar este atributo a un método de evento ETW definido en una EventSourceclase derivada, debe llamar al WriteEvent método en la clase base, pasando el identificador de evento, seguido de los mismos argumentos que el método definido. Debe seguir el patrón que se muestra en los ejemplos siguientes.

Constructores

EventAttribute(Int32)

Inicializa una nueva instancia de EventAttribute con el identificador de eventos especificado.

Propiedades

ActivityOptions	Especifica el comportamiento de los eventos de inicio y detención de una actividad. Una actividad es la región de tiempo en una aplicación entre el inicio y la detención.
Channel	Obtiene o establece un registro de eventos adicional donde se debe escribir el evento.
EventId	Obtiene o establece el identificador del evento.
Keywords	Obtiene o establece las palabras clave del evento.
Level	Obtiene o establece el nivel del evento.
Message	Obtiene o establece el mensaje del evento.
Opcode	Obtiene o establece el código de operación para el evento.
Tags	Obtiene o establece el valor de EventTags para el objeto EventAttribute. Una etiqueta de evento es un valor definido por el usuario que se pasa cuando se registra el evento.
Task	Obtiene o establece la tarea del evento.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)
Version	Obtiene o establece la versión del evento.

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a las propiedades y los métodos expuestos por un objeto. (Heredado de Attribute)

Se aplica a

Compartir a través de