BackgroundTransferCompletionGroup Classe

Définition

Espace de noms:

Windows.Networking.BackgroundTransfer

Représente un ensemble d’opérations de transfert en arrière-plan (objets DownloadOperation ou UploadOperation ) qui déclenchent une tâche en arrière-plan une fois que toutes les opérations sont terminées (si les opérations se sont terminées avec succès) ou échouent avec une erreur.

public ref class BackgroundTransferCompletionGroup sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BackgroundTransferCompletionGroup final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BackgroundTransferCompletionGroup

function BackgroundTransferCompletionGroup()

Public NotInheritable Class BackgroundTransferCompletionGroup

Héritage

Object Platform::Object IInspectable BackgroundTransferCompletionGroup

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

La classe BackgroundTransferCompletionGroup permet à une application de s’inscrire pour recevoir une notification immédiate une fois les opérations de transfert en arrière-plan terminées, même si l’application n’est pas au premier plan. L’application inscrit une tâche en arrière-plan pour recevoir une notification qui se produit si les transferts en arrière-plan se sont terminés correctement ou si une erreur s’est produite. Cela permet à l’application d’être immédiatement avertie au moment de l’exécution, au lieu d’exiger que l’application attende la prochaine fois qu’elle est redémarrée ou déplacée au premier plan pour interroger les achèvements.

L’application doit implémenter IBackgroundTask pour s’exécuter et recevoir les notifications d’achèvement. IBackgroundTask doit être inscrit à l’aide de la classe BackgroundTaskBuilder. Lorsque BackgroundTransferCompletionGroup.Trigger est utilisé pour configurer la tâche, l’infrastructure Broker annule automatiquement son inscription dès qu’elle est déclenchée, de sorte qu’il n’est pas nécessaire d’avoir un code explicite de désinscription de tâche.

La tâche en arrière-plan doit être déclarée dans le manifeste de l’application. L’application ne nécessite pas d’accès à l’écran de verrouillage pour utiliser un BackgroundTransferCompletionGroup.

Constructeurs

BackgroundTransferCompletionGroup()

Crée un objet BackgroundTransferCompletionGroup .

Propriétés

IsEnabled	Obtient une valeur qui indique si la méthode Enable sur un BackgroundTransferCompletionGroup a déjà été appelée.
Trigger	Obtient le IBackgroundTrigger utilisé pour configurer la tâche en arrière-plan associée à BackgroundTransferCompletionGroup.

Méthodes

Enable()

Indique que backgroundTransferCompletionGroup est terminé et qu’aucune autre opération de transfert en arrière-plan (objets DownloadOperation ou UploadOperation ) n’est ajoutée au groupe d’achèvement.

Voir aussi

• BackgroundTaskBuilder
• DownloadOperation
• IBackgroundTask
• UploadOperation