BackgroundTaskBuilder Classe

Définition

Espace de noms:

Windows.ApplicationModel.Background

Représente une tâche en arrière-plan à inscrire auprès du système.

public ref class BackgroundTaskBuilder sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BackgroundTaskBuilder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BackgroundTaskBuilder

function BackgroundTaskBuilder()

Public NotInheritable Class BackgroundTaskBuilder

Héritage

Object Platform::Object IInspectable BackgroundTaskBuilder

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Notes

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 Threading and Marshaling (C++/CX) et Utilisation d’objets Windows Runtime dans un environnement multithread (.NET).

Si votre tâche en arrière-plan nécessite une connectivité réseau, tenez compte des éléments suivants :

** Déclencheurs liés au réseau**

• Utilisez un SocketActivityTrigger pour activer la tâche en arrière-plan lorsqu’un paquet est reçu et que vous devez effectuer une tâche de courte durée. Après l’exécution de la tâche, la tâche en arrière-plan doit s’arrêter pour économiser de l’énergie.
• Utilisez un ControlChannelTrigger pour activer la tâche en arrière-plan lorsqu’un paquet est reçu et que vous devez effectuer une tâche de longue durée.

** Conditions et indicateurs liés au réseau**

• Ajoutez la condition InternetAvailable (BackgroundTaskBuilder.AddCondition) à votre tâche en arrière-plan pour retarder le déclenchement de la tâche en arrière-plan jusqu’à ce que la pile réseau soit en cours d’exécution. Cette condition permet d’économiser de l’énergie, car la tâche en arrière-plan ne s’exécute pas tant que l’accès réseau n’est pas disponible. Cette condition ne fournit pas d’activation en temps réel.

Quel que soit le déclencheur que vous utilisez, définissez IsNetworkRequested sur votre tâche en arrière-plan pour vous assurer que le réseau reste opérationnel pendant que cette tâche s’exécute. Cela indique à l’infrastructure de tâches en arrière-plan qu’elle doit maintenir le réseau actif pendant l’exécution de la tâche, même si le périphérique est passé en mode de veille connectée. Si votre tâche en arrière-plan n’utilise pas IsNetworkRequested, votre tâche en arrière-plan ne pourra pas accéder au réseau en mode veille connectée (par exemple, lorsque l’écran d’un téléphone est désactivé).)

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1703	15063	Taskgroup
2004	19041	SetTaskEntryPointClsid

Constructeurs

BackgroundTaskBuilder()

Crée un instance de la classe BackgroundTaskBuilder.

Propriétés

AllowRunningTaskInStandby	Représente une tâche en arrière-plan à inscrire auprès du système.
CancelOnConditionLoss	Indique si la tâche en arrière-plan sera annulée si au moins l’une de ses conditions requises n’est plus remplie.
IsNetworkRequested	Indique s’il faut maintenir le réseau opérationnel lors de l’exécution de la tâche en arrière-plan.
IsRunningTaskInStandbySupported	Représente une tâche en arrière-plan à inscrire auprès du système.
Name	Obtient ou définit le nom d’une tâche en arrière-plan.
TaskEntryPoint	Obtient ou définit la classe qui effectue le travail d’une tâche en arrière-plan.
TaskGroup	Obtient et définit l’identificateur de groupe.

Méthodes

AddCondition(IBackgroundCondition)	Ajoute une condition à une tâche en arrière-plan.
Register()	Inscrit une tâche en arrière-plan auprès du système.
Register(String)	Représente une tâche en arrière-plan à inscrire auprès du système.
SetTaskEntryPointClsid(Guid)	Affecte un point d’entrée CLSID COM à l’aide d’un objet BackgroundTaskBuilder existant.
SetTrigger(IBackgroundTrigger)	Définit le déclencheur d’événement pour une tâche en arrière-plan.
Validate()	Représente une tâche en arrière-plan à inscrire auprès du système.