LoggingActivity 類別

定義

命名空間:

Windows.Foundation.Diagnostics

建立 Windows 事件追蹤 (ETW) 事件，以標記相關事件的開始和結束。

public ref class LoggingActivity sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingActivityFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LoggingActivity final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingActivityFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingActivity : System.IDisposable

function LoggingActivity(activityName, loggingChannel, level)

Public NotInheritable Class LoggingActivity
Implements IDisposable

繼承

Object Platform::Object IInspectable LoggingActivity

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IClosable IDisposable ILoggingTarget

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

Windows 10LoggingActivity類別已透過下列方式擴充：+ 現在會實作ILoggingTarget，以提供活動啟動和停止方法，以控制 Start 和 Stop 事件的格式和內容。

• 現在會實作方法來記錄事件。 事件會自動加上 LoggingActivity 的 GUID標記。
• 活動可以是巢狀結構。 每個 LoggingActivity 物件都會附加至 LoggingChannel 物件。 LoggingActivity物件所建立的所有事件都會透過附加的LoggingChannel物件寫入。

建構函式

LoggingActivity(String, ILoggingChannel)	在相容性模式 Windows 8.1中，初始化指定之 LoggingChannel之LoggingActivity類別的新實例。
LoggingActivity(String, ILoggingChannel, LoggingLevel)	在相容性模式 Windows 8.1中，為指定的LoggingChannel和LoggingLevel初始化LoggingActivity類別的新實例。

屬性

Channel	傳回與此活動相關聯的通道。
Id	取得目前記錄活動的識別碼。
Name	取得目前記錄活動的名稱。

方法

Close()	結束目前的記錄活動。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
IsEnabled()	指出至少有一個會話正在接聽與此活動相關聯之通道的事件。
IsEnabled(LoggingLevel)	指出至少有一個會話正在接聽與這個活動相關聯之通道中具有指定事件嚴重性層級的事件。
IsEnabled(LoggingLevel, Int64)	指出至少有一個會話正在接聽具有指定層級的事件，以及來自與此活動相關聯之通道的關鍵字。
LogEvent(String)	記錄具有指定名稱的事件。
LogEvent(String, LoggingFields)	記錄具有指定名稱和欄位的事件。
LogEvent(String, LoggingFields, LoggingLevel)	記錄具有指定名稱、欄位和層級的事件。
LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions)	記錄具有指定名稱、欄位、層級和選項的事件。
StartActivity(String)	寫入活動開始事件，並建立 LoggingActivity 物件。
StartActivity(String, LoggingFields)	使用欄位寫入活動開始事件，並建立 LoggingActivity 物件。
StartActivity(String, LoggingFields, LoggingLevel)	使用指定的欄位和層級寫入活動開始事件，並建立 LoggingActivity 物件。
StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions)	寫入具有指定欄位、層級和選項的活動開始事件，並建立 LoggingActivity 物件。
StopActivity(String)	將活動標示為已關閉/處置，並產生具有指定事件名稱的停止事件。
StopActivity(String, LoggingFields)	將活動標示為已關閉/處置，並產生具有指定事件名稱和欄位的停止事件。
StopActivity(String, LoggingFields, LoggingOptions)	將活動標示為已關閉/處置，並產生具有指定事件名稱、欄位和選項的停止事件。

另請參閱

• IClosable
• LoggingChannel
• ILoggingTarget
• 記錄範例 (Windows 10)