BackgroundTaskRegistration, classe

BackgroundTaskRegistration Class

Représente une tâche en arrière-plan qui a été enregistrée dans le système.

Syntaxe


var backgroundTaskRegistration = Windows.ApplicationModel.Background.BackgroundTaskRegistration;

Attributs

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Membres

BackgroundTaskRegistrationClasse possède ces types de membres :

Événements

BackgroundTaskRegistrationClasse possède ces événements.

ÉvénementDescription
Completed Attaches a completed event handler to the registered background task.
Progress Attaches a progress event handler to the registered background task.

 

Méthodes

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

MéthodeDescription
Unregister Cancels the registration of a registered background task.

 

Propriétés

Le BackgroundTaskRegistrationClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

AllTasks

En lecture seuleEnumerates an application's registered background tasks.

Name

En lecture seuleGets the name of a registered background task.

TaskId

En lecture seuleGets the identifier of a registered background task.

 

Remarques

Le système retourne une instance de cette classe lorsque l'application appelle la méthode BackgroundTaskBuilder.Register.

Exemples

L'exemple suivant montre comment utiliser la propriété AllTasks de la classe BackgroundTaskRegistration pour récupérer l'objet d'enregistrement des tâches en arrière-plan existantes pour la tâche en arrière-plan de votre application (si la tâche est actuellement enregistrée).


//
// The name of the background task for your app.
//
string name = "ExampleTaskName";

//
// Get a list of all background tasks. The list is returned as
// a dictionary of IBackgroundTaskRegistration objects.
//
foreach (var cur in BackgroundTaskRegistration.AllTasks)
{
if (cur.Value.Name == name)
    {
        //
        // Take some action based on finding the background task.

        //
        // For example, unregister the task:
        //
        // cur.Value.Unregister(true);

        // 
        // Or, set a global variable indicating that the task is
        // already registered:
        //
        // TaskAlreadyRegistered = true;
    }
}

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:
© 2016 Microsoft