EventProvider 類別

定義

命名空間:

System.Diagnostics.Eventing

組件:

System.Core.dll

使用此類別 (Class) 來寫入事件。

C#

public class EventProvider : IDisposable

繼承

Object

EventProvider

實作

IDisposable

備註

若要取用使用 WriteEvent 和 WriteTransferEvent 方法寫入的事件，必須在指令清單中定義事件;使用 WriteMessageEvent 方法撰寫的事件不需要指令清單。

事件可以包含下列 Managed 資料類型：

• bool

• 布林值

• byte

• char

• decimal

• double

• FLOAT

• Guid

• int

• IntPtr

• long

• sbyte

• short

• 字串

• uint

• UInt64

如果指令清單中的事件使用 Boolean 類型內，則您無法在 Managed 程式代碼中使用 Boolean 資料類型來撰寫資料元素。 指令 Boolean 清單中的類型需要 4 位元組值，而 Boolean Managed 程式代碼中的數據類型為 1 位元組。 相反地，您必須使用 int 資料類型來寫入值。 如果您想要記錄 Boolean 值，請在指令清單中使用 UInt8 類型。

建構函式

EventProvider(Guid)

初始化 EventProvider 類別的新執行個體。

方法

Close()	從 ETW 子系統移除提供者的註冊，並釋放所有的 Unmanaged 資源。
CreateActivityId()	建立提供者的唯一活動識別項。
Dispose()	釋放這個 EventProvider 物件所使用的資源。
Dispose(Boolean)	釋放這個 EventProvider 物件所使用的資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Finalize()	釋出資源並執行內部清除後，記憶體回收才能回收執行個體。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLastWriteEventError()	取得與事件寫入失敗相關的最後一項錯誤。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsEnabled()	判斷是否有任何工作階段已啟用提供者 (不論用來啟用提供者的層級和關鍵字值為何)。
IsEnabled(Byte, Int64)	判斷是否有任何工作階段正在向提供者要求指定的事件。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SetActivityId(Guid)	設定 WriteEvent 方法使用的目前活動識別項。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
WriteEvent(EventDescriptor, Int32, IntPtr)	寫入事件。 事件資料會指定為記憶體區塊。
WriteEvent(EventDescriptor, Object[])	寫入事件。 事件資料會指定為物件陣列。
WriteEvent(EventDescriptor, String)	寫入事件。 事件資料會指定為字串。
WriteMessageEvent(String)	寫入內含字串做為資料的事件。
WriteMessageEvent(String, Byte, Int64)	如果層級和關鍵字值符合工作階段所要求的事件，便會寫入包含字串資料的事件。
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)	在端對端案例中追蹤事件時，將事件連結在一起。 事件資料會指定為記憶體區塊。
WriteTransferEvent(EventDescriptor, Guid, Object[])	在端對端案例中追蹤事件時，將事件連結在一起。 事件資料會指定為物件陣列。

適用於