EventAttribute Classe

Definizione

Spazio dei nomi:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Origine:

EventSource.cs

Specifica informazioni aggiuntive dello schema di eventi per 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

Ereditarietà

Object

Attribute

EventAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene illustrato come usare la EventAttribute classe per definire un'ampia gamma di eventi. Questo esempio di codice fa parte di un esempio più grande fornito per 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

Commenti

Quando si applica questo attributo a un metodo evento ETW definito in una EventSourceclasse derivata, è necessario chiamare il metodo nella classe base, passando l'ID WriteEvent evento, seguito dagli stessi argomenti del metodo definito. È consigliabile seguire il modello illustrato negli esempi seguenti.

Costruttori

EventAttribute(Int32)

Inizializza una nuova istanza della classe EventAttribute con l'identificatore dell'evento specificato.

Proprietà

ActivityOptions	Specifica il comportamento degli eventi di avvio e arresto di un'attività. Un'attività è l'area temporale in un'app tra l'avvio e l'arresto.
Channel	Ottiene o imposta un registro eventi aggiuntivo in cui deve essere scritto l'evento.
EventId	Ottiene o imposta l'identificatore per l'evento.
Keywords	Ottiene o imposta le parole chiave per l'evento.
Level	Ottiene o imposta il livello per l'evento.
Message	Ottiene o imposta un messaggio per l'evento.
Opcode	Ottiene o imposta il codice operativo per l'evento.
Tags	Ottiene o imposta il valore EventTags per questo oggetto EventAttribute. Un tag evento è un valore definito dall'utente che viene passato quando l'evento viene registrato.
Task	Ottiene o imposta l'attività per l'evento.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)
Version	Ottiene o imposta la versione dell'evento.

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)