BackgroundExecutionManager Class

Fournit des méthodes qui permettent à une application de demander à être ajoutée à la liste des applications de l'écran de verrouillage ou d'interroger son accès actuel à l'activité en arrière-plan et aux mises à jour de badge sur l'écran de verrouillage.

Syntaxe


var backgroundExecutionManager = Windows.ApplicationModel.Background.BackgroundExecutionManager;

Attributs

[Version(0x06020000)]

Membres

BackgroundExecutionManagerClasse possède ces types de membres :

Méthodes

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

MéthodeDescription
GetAccessStatus() Gets the ability of the calling lock screen app to perform background activity and update its badge.
GetAccessStatus(String) Gets the ability of a specific lock screen app to perform background activity and update its badge.
RemoveAccess() Removes the calling app from the lock screen's apps list.
RemoveAccess(String) Removes a specific app from the lock screen's apps list.
RequestAccessAsync() Presents the user with a dialog box that requests that the calling app be added to the lock screen.
RequestAccessAsync(String) Presents the user with a dialog box that requests that the specified app be added to the lock screen.

 

Remarques

Dans la mesure où il permet aux applications avec une présence sur l'écran de verrouillage d'exécuter des tâches en arrière-plan, certaines classes d'applications nécessitent l'accès obtenu à cette classe pour exécuter leurs principaux scénarios.

Pour obtenir un exemple complet illustrant l'utilisation de cette classe, consultez l'exemple d'écran de verrou dans le Centre de développement Windows.

Exemples

Cet exemple illustre l'utilisation de cette classe pour ajouter une application à l'écran de verrouillage et lui accorder la possibilité d'effectuer des tâches en arrière-plan.


var Background = Windows.ApplicationModel.Background;

var promise = Background.BackgroundExecutionManager.requestAccessAsync().then(
    function(result) {
        switch (result) {
        case Background.BackgroundAccessStatus.denied:
            // Disabled by the user. 
            break;

        case Background.BackgroundAccessStatus.allowedWithAlwaysOnRealTimeConnectivity:
            // Added to list of background apps.
            // Set up background tasks; can use the network connectivity broker.
            break;

        case Background.BackgroundAccessStatus.allowedMayUseActiveRealTimeConnectivity:
            // Added to list of background apps.
            // Set up background tasks; cannot use the network connectivity broker.
            break;

        case Background.BackgroundAccessStatus.unspecified:
            // The user didn't explicitly disable or enable. 
            break;
        }
    });

Suppression d'une application de l'écran de verrouillage.


var Background = Windows.ApplicationModel.Background;
Background.BackgroundExecutionManager.removeAccess();

Cet exemple montre comment rechercher l'état de l'écran de verrouillage d'une application.


var Background = Windows.ApplicationModel.Background;

var result = Background.BackgroundApplications.getAccessStatus();
switch (result) {
case Background.BackgroundAccessStatus.denied:
    // Disabled by the user.
    // Cannot display on the lock screen or set up background tasks.
    break;

case Background.BackgroundAccessStatus.allowedWithAlwaysOnRealTimeConnectivity:
    // Added to list of background applications.
    // Can display on the lock screen.
    // Can set up background tasks and use the network connectivity broker.
    break;

case Background.BackgroundAccessStatus.allowedMayUseActiveRealTimeConnectivity:
    // Added to list of background applications.
    // Can display on the lock screen.
    // Can set up background tasks but cannot use the network connectivity broker.
    break;

case Background.BackgroundAccessStatus.unspecified:
    // The user didn't explicitly disable or enable.
    break;
}

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

Voir aussi

Exemple d'applications de l'écran de verrouillage

 

 

Afficher:
© 2015 Microsoft