語言

DispatcherQueue 類別

定義

命名空間:
Microsoft.UI.Dispatching
編輯

管理一個優先順序的佇列，任務在執行緒中以序列方式執行。

public ref class DispatcherQueue sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DispatcherQueue final
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class DispatcherQueue final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DispatcherQueue
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class DispatcherQueue
Public NotInheritable Class DispatcherQueue
繼承
Object Platform::Object IInspectable DispatcherQueue
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

備註

所有派遣到佇列的任務都會在同一執行緒執行。

屬性

名稱 Description
HasThreadAccess

會獲得一個值，表示 DispatcherQueue 是否能存取目前執行緒。

方法

名稱 Description
CreateTimer()

在 DispatcherQueue 上建立一個 DispatcherQueueTimer，以便在時間間隔過後定期執行任務。
EnqueueEventLoopExit()

會排隊訊息迴圈結束訊息。
EnsureSystemDispatcherQueue()

造成 Microsoft。UI。Dispatching.DispatcherQueue 來管理系統 DispatcherQueue 的關閉（Windows.System.DispatcherQueue）來自同一執行緒。
GetForCurrentThread()

取得與目前執行緒相關的 DispatcherQueue 。
RunEventLoop()

執行訊息迴圈，直到呼叫 EnqueueEventLoopExit 或 PostQuitMessage 其中一方。 同時也負責啟動 ShutdownStarting/ShutdownCompleted 和 FrameworkShutdownStarting/FrameworkShutdownCompleted 事件。
RunEventLoop(DispatcherRunOptions, DispatcherExitDeferral)

執行訊息迴圈，直到呼叫 EnqueueEventLoopExit 或 PostQuitMessage 其中一方。 同時也負責啟動 ShutdownStarting/ShutdownCompleted 和 FrameworkShutdownStarting/FrameworkShutdownCompleted 事件。
TryEnqueue(DispatcherQueueHandler)

將任務加入 DispatcherQueue ，該任務將在與 DispatcherQueue 關聯的執行緒上執行。
TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler)

將一個任務加入 DispatcherQueue，該任務將在與 DispatcherQueue 關聯的執行緒上執行，且具有指定優先權。

事件

名稱 Description
FrameworkShutdownCompleted

當呼叫 ShutdownQueue 或 ShutdownQueueAsync 時，會被提升。 關於被提出事件的完整列表及其順序，請參閱 ShutdownQueueAsync 備註。
FrameworkShutdownStarting

當呼叫 ShutdownQueue 或 ShutdownQueueAsync 時，會被提升。 關於被提出事件的完整列表及其順序，請參閱 ShutdownQueueAsync 備註。
ShutdownCompleted

當呼叫 ShutdownQueue 或 ShutdownQueueAsync 時，會被提升。 關於被提出事件的完整列表及其順序，請參閱 ShutdownQueueAsync 備註。
ShutdownStarting

當呼叫 ShutdownQueue 或 ShutdownQueueAsync 時，會被提升。 關於被提出事件的完整列表及其順序，請參閱 ShutdownQueueAsync 備註。

適用於