DispatcherQueue.TryEnqueue Méthode

Définition

Espace de noms:

Microsoft.UI.Dispatching

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 Boolean

Paramètres

callback

DispatcherQueueHandler

Délégué à la tâche à exécuter.

Retours

Boolean

bool

True si la tâche a été ajoutée à la file d’attente. Dans le cas contraire, la valeur est false.

Attributs

OverloadAttribute

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.

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 Boolean

Paramè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

Boolean

bool

True si la tâche a été ajoutée à la file d’attente. Dans le cas contraire, la valeur est false.

Attributs

OverloadAttribute

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.