DispatcherQueue.TryEnqueue 方法

参考

定义

命名空间:: Microsoft.UI.Dispatching

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

TryEnqueue(DispatcherQueueHandler)	将任务添加到 DispatcherQueue ，该任务将在与 DispatcherQueue 关联的线程上执行。
TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler)	向 DispatcherQueue 添加一个任务，该任务将在具有指定优先级的 DispatcherQueue 关联的线程上执行。

TryEnqueue(DispatcherQueueHandler)

编辑

将任务添加到 DispatcherQueue ，该任务将在与 DispatcherQueue 关联的线程上执行。

public:
 virtual bool TryEnqueue(DispatcherQueueHandler ^ callback) = TryEnqueue;

[Windows.Foundation.Metadata.Overload("TryEnqueue")]
public bool TryEnqueue(DispatcherQueueHandler callback);

function tryEnqueue(callback)

Public Function TryEnqueue (callback As DispatcherQueueHandler) As Boolean

参数

callback: DispatcherQueueHandler

要执行的任务的委托。

Boolean

bool

如此如果 任务已添加到队列。否则为 false。

属性: OverloadAttribute

示例

以下示例演示如何创建新线程并初始化 DispatcherQueueController 并对其运行 DispatcherQueue 事件循环。

// Create a new thread and initialize a DispatcherQueueController
// and run a DispatcherQueue event loop on it.
_queueController =
    DispatcherQueueController.CreateOnDedicatedThread();
_queue = _queueController.DispatcherQueue;

// This is the first TryEnqueue() after creating the DispatcherQueue. The
// first TryEnqueue task is guaranteed to be invoked first on the new
// thread.
bool isQueued = _queue.TryEnqueue(
        () =>
        {
            // task to perform on another thread.
        });

注解

队列将串行调用回调。

调用 ShutdownQueueAsync () 后，队列不会对新任务进行排队，此方法将返回 false。

适用于

TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler)

编辑

向 DispatcherQueue 添加一个任务，该任务将在具有指定优先级的 DispatcherQueue 关联的线程上执行。

public:
 virtual bool TryEnqueue(DispatcherQueuePriority priority, DispatcherQueueHandler ^ callback) = TryEnqueue;

[Windows.Foundation.Metadata.Overload("TryEnqueueWithPriority")]
public bool TryEnqueue(DispatcherQueuePriority priority, DispatcherQueueHandler callback);

function tryEnqueue(priority, callback)

Public Function TryEnqueue (priority As DispatcherQueuePriority, callback As DispatcherQueueHandler) As Boolean

参数

priority: DispatcherQueuePriority

任务的优先级 (，例如低、正常或高) 。

callback: DispatcherQueueHandler