DispatcherQueue.TryEnqueue メソッド

定義

名前空間:

Windows.System

オーバーロード

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")]
bool TryEnqueue(DispatcherQueueHandler const& callback);

[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

True は 、タスクがキューに追加されたことを示します。 false、それ以外の場合は 。

属性

OverloadAttribute

例

// 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 callback is guaranteed to be invoked first despite Priority on the
// newly created 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")]
bool TryEnqueue(DispatcherQueuePriority const& priority, DispatcherQueueHandler const& callback);

[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

タスクの優先度 (Low、Normal、High など)。

callback

DispatcherQueueHandler

実行するタスクへのデリゲート。

戻り値

Boolean

bool

True は 、タスクがキューに追加されたことを示します。 false、それ以外の場合は 。

属性

OverloadAttribute

例

// 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, regardless of what priority it was enqueued at.


bool isQueued = _queue.TryEnqueue(Windows.System.DispatcherQueuePriority.High,
        () =>
        {
            // task to perform on another thread.
        });

注釈

キューはコールバック を順番に 、優先順位で呼び出します。

ShutdownQueueAsync() が呼び出されると、キューは新しいタスクをキューに登録せず、このメソッドは false を返します。