DispatcherQueue.TryEnqueue Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Dispatching

Overload

TryEnqueue(DispatcherQueueHandler)	Aggiunge un'attività al dispatcherQueue che verrà eseguito nel thread associato a DispatcherQueue.
TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler)	Aggiunge un'attività al dispatcherQueue che verrà eseguito nel thread associato a DispatcherQueue con la priorità specificata.

TryEnqueue(DispatcherQueueHandler)

Aggiunge un'attività al dispatcherQueue che verrà eseguito nel thread associato a 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

Parametri

callback

DispatcherQueueHandler

Delegato all'attività da eseguire.

Restituisce

Boolean

bool

True se l'attività è stata aggiunta alla coda. In caso contrario, false.

Attributi

OverloadAttribute

Esempio

Nell'esempio seguente viene illustrato come creare un nuovo thread e inizializzare un dispatcherQueueController ed eseguire un ciclo di eventi 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.
        });

Commenti

La coda richiamerà il callback serialmente.

Dopo aver chiamato ShutdownQueueAsync(), la coda non accoderà nuove attività e questo metodo restituirà false.

TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler)

Aggiunge un'attività al dispatcherQueue che verrà eseguito nel thread associato a DispatcherQueue con la priorità specificata.

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

Parametri

priority

DispatcherQueuePriority

Priorità dell'attività , ad esempio Low, Normal o High.

callback

DispatcherQueueHandler

Delegato all'attività da eseguire.

Restituisce

Boolean

bool

True se l'attività è stata aggiunta alla coda. In caso contrario, false.

Attributi

OverloadAttribute

Esempio

Nell'esempio seguente viene illustrato come creare un nuovo thread e inizializzare un dispatcherQueueController ed eseguire un ciclo di eventi 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.
        });

Commenti

La coda richiamerà il callback serialmente e in ordine di priorità.

Dopo aver chiamato ShutdownQueueAsync(), la coda non accoderà nuove attività e questo metodo restituirà false.