BackgroundExecutionManager.RequestAccessAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
RequestAccessAsync() |
Demande que l’application soit autorisée à exécuter des tâches en arrière-plan. |
RequestAccessAsync(String) |
Demande de manière asynchrone que l’application soit autorisée à exécuter des tâches en arrière-plan. |
RequestAccessAsync()
Demande que l’application soit autorisée à exécuter des tâches en arrière-plan.
public:
static IAsyncOperation<BackgroundAccessStatus> ^ RequestAccessAsync();
/// [Windows.Foundation.Metadata.Overload("RequestAccessAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync();
[Windows.Foundation.Metadata.Overload("RequestAccessAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync();
function requestAccessAsync()
Public Shared Function RequestAccessAsync () As IAsyncOperation(Of BackgroundAccessStatus)
Retours
Une fois l’opération terminée, elle retourne un membre de l’énumération BackgroundAccessStatus qui spécifie le résultat.
- Attributs
Remarques
Version | Comportement |
Windows 8 et Windows 8.1 | Invite l’utilisateur avec une boîte de dialogue qui demande qu’une application soit ajoutée à l’écran de verrouillage. Doit être appelé avant d’inscrire des tâches en arrière-plan. |
Windows Phone 8.1 | N’invite pas l’utilisateur, mais doit être appelé avant d’inscrire des tâches en arrière-plan. |
Windows 10 | N’invite pas l’utilisateur, mais doit être appelé avant d’inscrire des tâches en arrière-plan. Vous n’avez pas besoin d’ajouter l’application à l’écran de verrouillage pour utiliser des tâches en arrière-plan dans Windows 10, mais vous devez toujours appeler cette méthode pour demander l’accès en arrière-plan. |
Conseil
À compter de Windows 10, il n’est plus nécessaire d’appeler cette méthode à partir du thread d’interface utilisateur.
Voir aussi
S’applique à
RequestAccessAsync(String)
Demande de manière asynchrone que l’application soit autorisée à exécuter des tâches en arrière-plan.
public:
static IAsyncOperation<BackgroundAccessStatus> ^ RequestAccessAsync(Platform::String ^ applicationId);
/// [Windows.Foundation.Metadata.Overload("RequestAccessForApplicationAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync(winrt::hstring const& applicationId);
[Windows.Foundation.Metadata.Overload("RequestAccessForApplicationAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync(string applicationId);
function requestAccessAsync(applicationId)
Public Shared Function RequestAccessAsync (applicationId As String) As IAsyncOperation(Of BackgroundAccessStatus)
Paramètres
- applicationId
-
String
Platform::String
winrt::hstring
Identificateur d’application relatif au package (PRAID) de l’application à autoriser à exécuter des tâches en arrière-plan. L’application spécifiée doit se trouver dans le même package que l’application appelante. Pour plus d’informations sur le PRAID, consultez l’attribut ID de l’élément Application .
Si vous hébergez des tâches en arrière-plan sur un serveur COM hors processus, distinct de votre application main, passez comme argument du applicationId
PRAID de l’application qui définit l’extension windows.backgroundTask
dans son propre manifeste de package.
Retours
Opération de requête asynchrone. Une fois la saisie terminée, contient un membre de l’énumération BackgroundAccessStatus qui spécifie le résultat.
- Attributs
Remarques
Version | Comportement |
---|---|
Windows 8 et Windows 8.1 | Invite l’utilisateur avec une boîte de dialogue qui demande qu’une application soit ajoutée à l’écran de verrouillage. Doit être appelé avant d’inscrire des tâches en arrière-plan. |
Windows Phone 8.1 | N’invite pas l’utilisateur, mais doit être appelé avant d’inscrire des tâches en arrière-plan. |
Windows 10 | N’invite pas l’utilisateur, mais doit être appelé avant d’inscrire des tâches en arrière-plan. Vous n’avez pas besoin d’ajouter l’application à l’écran de verrouillage pour utiliser des tâches en arrière-plan dans Windows 10, mais vous devez toujours appeler cette méthode, ou RequestAccessAsync, pour demander l’accès en arrière-plan. |
Conseil
À compter de Windows 10, il n’est plus nécessaire d’appeler cette méthode à partir du thread d’interface utilisateur.