BackgroundTaskDeferral Class

Représente un différé de tâche en arrière-plan retourné par la méthode IBackgroundTaskInstance.GetDeferral.

Syntaxe


var backgroundTaskDeferral = Windows.ApplicationModel.Background.IBackgroundTaskInstance.GetDeferral();

Attributs

[MarshalingBehavior(Standard)]
[Threading(MTA)]
[Version(0x06020000)]

Membres

BackgroundTaskDeferralClasse possède ces types de membres :

Méthodes

The BackgroundTaskDeferral Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
Complete Informs the system that an asynchronous operation associated with a background task has finished.

 

Remarques

Remarque   : cette classe n'est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d'informations, consultez Threads et marshaling (C++/CX) et Utilisation d'objets Windows Runtime dans un environnement multithread (.NET).

Exemples

L'exemple suivant montre comment utiliser un différé de tâche en arrière-plan pour empêcher une tâche de se fermer prématurément lorsque du code asynchrone est encore en cours d'exécution.


//
// Declare that your background task's Run method makes asynchronous calls by
// using the async keyword.
//
public async void Run(IBackgroundTaskInstance taskInstance)
{
    //
    // Create the deferral by requesting it from the task instance.
    //
    BackgroundTaskDeferral deferral = taskInstance.GetDeferral();
    
    //
    // Call asynchronous method(s) using the await keyword.
    //
    var result = await ExampleMethodAsync();

    //
    // Once the asynchronous method(s) are done, close the deferral.
    //
    deferral.Complete();
}

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.ApplicationModel.Background
Windows::ApplicationModel::Background [C++]

Métadonnées

Windows.winmd

 

 

Afficher:
© 2014 Microsoft