DispatcherQueue.TryEnqueue Méthode

Définition

Espace de noms:

Windows.System

Surcharges

TryEnqueue(DispatcherQueueHandler)	Ajoute une tâche à DispatcherQueue qui sera exécutée sur le thread associé à DispatcherQueue.
TryEnqueue(DispatcherQueuePriority, DispatcherQueueHandler)	Ajoute une tâche à DispatcherQueue qui sera exécutée sur le thread associé à DispatcherQueue.

TryEnqueue(DispatcherQueueHandler)

Ajoute une tâche à DispatcherQueue qui sera exécutée sur le thread associé à 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 Boolean

Paramètres

callback

DispatcherQueueHandler

Tâche à exécuter.

Retours

Boolean

bool

True indique que la tâche a été ajoutée à la file d’attente ; false, sinon.

Attributs

OverloadAttribute

Exemples

// 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.
        });

Remarques

La tâche sera mise en file d’attente à priorité normale . La file d’attente appelle le rappel en série et dans l’ordre de priorité.

Une fois ShutdownQueueAsync() 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 à DispatcherQueue qui sera exécutée sur le thread associé à 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 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 indique que la tâche a été ajoutée à la file d’attente ; false, sinon.

Attributs

OverloadAttribute

Exemples

// 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 ShutdownQueueAsync() appelé, la file d’attente ne met pas en file d’attente les nouvelles tâches et cette méthode retourne false.