DispatcherQueue.TryEnqueue Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| TryEnqueue(DispatcherQueueHandler) |
Agrega una tarea a DispatcherQueue que se ejecutará en el subproceso asociado a DispatcherQueue. |
| TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler) |
Agrega una tarea a DispatcherQueue que se ejecutará en el subproceso asociado a DispatcherQueue. |
TryEnqueue(DispatcherQueueHandler)
Agrega una tarea a DispatcherQueue que se ejecutará en el subproceso asociado a 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 BooleanParámetros
- callback
- DispatcherQueueHandler
Tarea que se va a ejecutar.
Devoluciones
bool
True indica que la tarea se agregó a la cola; false, de lo contrario.
- Atributos
Ejemplos
// 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.
});
Comentarios
La tarea se pondrá en cola con prioridad normal . La cola invocará la devolución de llamada en serie y en orden de prioridad.
Una vez que se haya llamado a ShutdownQueueAsync(), la cola no pondrá en cola nuevas tareas y este método devolverá false.
Se aplica a
TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler)
Agrega una tarea a DispatcherQueue que se ejecutará en el subproceso asociado a 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 BooleanParámetros
- priority
- DispatcherQueuePriority
Prioridad de la tarea, como Baja, Normal o Alta.
- callback
- DispatcherQueueHandler
Delegado de la tarea que se va a ejecutar.
Devoluciones
bool
True indica que la tarea se agregó a la cola; false, de lo contrario.
- Atributos
Ejemplos
// 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.
});
Comentarios
La cola invocará la devolución de llamada en serie y en orden de prioridad.
Una vez que se haya llamado a ShutdownQueueAsync(), la cola no pondrá en cola nuevas tareas y este método devolverá false.