EventAttribute Klasa

Definicja

Przestrzeń nazw:

System.Diagnostics.Tracing

Zestaw:

System.Diagnostics.Tracing.dll

Źródło:

EventSource.cs

Określa dodatkowe informacje o schemacie zdarzeń dla zdarzenia.

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

Dziedziczenie

Object

Attribute

EventAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie pokazano, jak używać EventAttribute klasy do definiowania różnych zdarzeń. Ten przykład kodu jest częścią większego przykładu podanego EventSource dla klasy.

[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

Uwagi

Po zastosowaniu tego atrybutu do metody zdarzenia ETW zdefiniowanej w klasie pochodnej EventSourcenależy wywołać WriteEvent metodę w klasie bazowej, przekazując identyfikator zdarzenia, a następnie te same argumenty co zdefiniowana metoda jest przekazywana. Należy postępować zgodnie ze wzorcem przedstawionym w poniższych przykładach.

Konstruktory

EventAttribute(Int32)

Inicjuje EventAttribute nowe wystąpienie klasy przy użyciu określonego identyfikatora zdarzenia.

Właściwości

ActivityOptions	Określa zachowanie zdarzeń uruchamiania i zatrzymywania działania. Działanie to region czasu w aplikacji między rozpoczęciem a zatrzymaniem.
Channel	Pobiera lub ustawia dodatkowy dziennik zdarzeń, w którym ma zostać zapisane zdarzenie.
EventId	Pobiera lub ustawia identyfikator zdarzenia.
Keywords	Pobiera lub ustawia słowa kluczowe zdarzenia.
Level	Pobiera lub ustawia poziom zdarzenia.
Message	Pobiera lub ustawia komunikat dla zdarzenia.
Opcode	Pobiera lub ustawia kod operacji dla zdarzenia.
Tags	Pobiera lub ustawia EventTags wartość dla tego EventAttribute obiektu. Tag zdarzenia to wartość zdefiniowana przez użytkownika, która jest przekazywana po zarejestrowaniu zdarzenia.
Task	Pobiera lub ustawia zadanie dla zdarzenia.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute)
Version	Pobiera lub ustawia wersję zdarzenia.

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	W przypadku zastąpienia w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)