EventAttribute Classe

Définition

Espace de noms:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Source:

EventSource.cs

Spécifie les informations de schéma d'événement supplémentaires pour un événement.

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

Héritage

Object

Attribute

EventAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant montre comment utiliser la EventAttribute classe pour définir divers événements. Cet exemple de code fait partie d’un exemple plus grand fourni pour la 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

Remarques

Lorsque vous appliquez cet attribut à une méthode d’événement ETW définie sur une EventSourceclasse dérivée, vous devez appeler la WriteEvent méthode sur la classe de base, en passant l’ID d’événement, suivi des mêmes arguments que la méthode définie est passée. Vous devez suivre le modèle illustré dans les exemples suivants.

Constructeurs

EventAttribute(Int32)

Initialise une nouvelle instance de la classe EventAttribute avec l'identificateur d'événement spécifié.

Propriétés

ActivityOptions	Spécifie le comportement des événements de démarrage et d’arrêt d’une activité. Dans une application, une activité est l’intervalle de temps entre le démarrage et l’arrêt.
Channel	Obtient ou définit un journal des événements supplémentaire dans lequel l'événement doit être écrit.
EventId	Obtient ou définit l'identificateur pour l'événement.
Keywords	Obtient ou définit les mots clés pour l'événement.
Level	Obtient ou définit le niveau de l'événement.
Message	Obtient ou définit le message pour l'événement.
Opcode	Obtient ou définit le code d'opération pour l'événement.
Tags	Obtient ou définit la valeur de EventTags pour cet objet EventAttribute. Une étiquette d’événement est une valeur définie par l’utilisateur qui est transmise quand l’événement est journalisé.
Task	Obtient ou définit la tâche de l'événement.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)
Version	Obtient ou définit la version de l'événement.

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)