DispatcherQueue.TryEnqueue Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 BooleanParametri
- callback
- DispatcherQueueHandler
Delegato all'attività da eseguire.
Restituisce
bool
True se l'attività è stata aggiunta alla coda. In caso contrario, false.
- Attributi
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.
Si applica a
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 BooleanParametri
- priority
- DispatcherQueuePriority
Priorità dell'attività , ad esempio Low, Normal o High.
- callback
- DispatcherQueueHandler
Delegato all'attività da eseguire.
Restituisce
bool
True se l'attività è stata aggiunta alla coda. In caso contrario, false.
- Attributi
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.