DispatcherQueue.TryEnqueue Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| TryEnqueue(DispatcherQueueHandler) |
Ajoute une tâche au DispatcherQueue qui sera exécutée sur le thread associé à DispatcherQueue. |
| TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler) |
Ajoute une tâche au DispatcherQueue qui sera exécutée sur le thread associé au DispatcherQueue avec la priorité spécifiée. |
TryEnqueue(DispatcherQueueHandler)
Ajoute une tâche au DispatcherQueue qui sera exécutée sur le thread associé à 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 BooleanParamètres
- callback
- DispatcherQueueHandler
Délégué à la tâche à exécuter.
Retours
bool
True si la tâche a été ajoutée à la file d’attente. Dans le cas contraire, la valeur est false.
- Attributs
Exemples
L’exemple suivant montre comment créer un thread et initialiser un DispatcherQueueController et y exécuter une boucle d’événement 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.
});
Remarques
La file d’attente appelle le rappel en série.
Une fois Que ShutdownQueueAsync() a été appelé, la file d’attente ne met pas en file d’attente les nouvelles tâches et cette méthode retourne false.
S’applique à
TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler)
Ajoute une tâche au DispatcherQueue qui sera exécutée sur le thread associé au DispatcherQueue avec la priorité spécifiée.
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 BooleanParamètres
- priority
- DispatcherQueuePriority
Priorité de la tâche (par exemple, Faible, Normal ou Élevé).
- callback
- DispatcherQueueHandler
Délégué à la tâche à exécuter.
Retours
bool
True si la tâche a été ajoutée à la file d’attente. Dans le cas contraire, la valeur est false.
- Attributs
Exemples
L’exemple suivant montre comment créer un thread et initialiser un DispatcherQueueController et y exécuter une boucle d’événement 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.
});
Remarques
La file d’attente appelle le rappel en série et dans l’ordre de priorité.
Une fois Que ShutdownQueueAsync() a été appelé, la file d’attente ne met pas en file d’attente les nouvelles tâches et cette méthode retourne false.