EventAttribute Třída

Definice

Obor názvů:

System.Diagnostics.Tracing

Sestavení:

System.Diagnostics.Tracing.dll

Zdroj:

EventSource.cs

Určuje další informace o schématu událostí pro událost.

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

Dědičnost

Object

Attribute

EventAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad ukazuje, jak použít EventAttribute třídu k definování různých událostí. Tento příklad kódu je součástí většího příkladu EventSource pro třídu.

[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

Poznámky

Použijete-li tento atribut na metodu událostí pro Windows definovanou EventSourcev odvozené třídě, musíte volat metodu WriteEvent v základní třídě a předat ID události následované stejnými argumenty, jako je předaná definovaná metoda. Měli byste postupovat podle vzoru uvedeného v následujících příkladech.

Konstruktory

EventAttribute(Int32)

Inicializuje novou instanci EventAttribute třídy se zadaným identifikátorem události.

Vlastnosti

ActivityOptions	Určuje chování událostí spuštění a zastavení aktivity. Aktivita je oblast času v aplikaci mezi spuštěním a zastavením.
Channel	Získá nebo nastaví další protokol událostí, kam by měla být zapsána událost.
EventId	Získá nebo nastaví identifikátor události.
Keywords	Získá nebo nastaví klíčová slova pro událost.
Level	Získá nebo nastaví úroveň události.
Message	Získá nebo nastaví zprávu pro událost.
Opcode	Získá nebo nastaví kód operace pro událost.
Tags	Získá nebo nastaví EventTags hodnotu pro tento EventAttribute objekt. Značka události je uživatelem definovaná hodnota, která se předává při protokolování události.
Task	Získá nebo nastaví úlohu pro událost.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)
Version	Získá nebo nastaví verzi události.

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)