DispatcherQueue.TryEnqueue Метод

Определение

Пространство имен:

Microsoft.UI.Dispatching

Перегрузки

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

Значение true , если задача была добавлена в очередь. В противном случае — 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

Делегат выполняемой задачи.

Возвращаемое значение

Boolean

bool

Значение true , если задача была добавлена в очередь. В противном случае — 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, regardless of what priority it was enqueued at.
bool isQueued = _queue.TryEnqueue(Windows.System.DispatcherQueuePriority.High,
        () =>
        {
            // task to perform on another thread.
        });

Комментарии

Очередь будет вызывать обратный вызов последовательно и в порядке приоритета.

После вызова ShutdownQueueAsync() очередь не будет ставить новые задачи в очередь, и этот метод вернет значение false.