BackgroundTransferCompletionGroup Classe

Definição

Namespace:

Windows.Networking.BackgroundTransfer

Representa um conjunto de operações de transferência em segundo plano (objetos DownloadOperation ou UploadOperation ) que disparam uma tarefa em segundo plano depois que todas as operações são feitas (se as operações foram concluídas com êxito) ou falham com um erro.

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

Herança

Object Platform::Object IInspectable BackgroundTransferCompletionGroup

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

A classe BackgroundTransferCompletionGroup permite que um aplicativo se registre para receber notificação imediata após a conclusão das operações de transferência em segundo plano, mesmo que o aplicativo não esteja em primeiro plano. O aplicativo registra uma tarefa em segundo plano para receber uma notificação que ocorre se as transferências em segundo plano forem concluídas com êxito ou se ocorreu um erro. Isso permite que o aplicativo seja notificado imediatamente no momento da conclusão, em vez de exigir que o aplicativo aguarde até a próxima vez que o aplicativo for reiniciado ou movido para o primeiro plano para consultar as conclusões.

O aplicativo deve implementar o IBackgroundTask para executar que recebe as notificações de conclusão. O IBackgroundTask deve ser registrado usando a classe BackgroundTaskBuilder . Quando BackgroundTransferCompletionGroup.Trigger for usado para configurar a tarefa, a Infraestrutura do Agente o cancelará automaticamente assim que for disparada, portanto, não será necessário ter nenhum código de cancelamento de registro de tarefa explícito.

A tarefa em segundo plano deve ser declarada no manifesto do aplicativo. O aplicativo não requer acesso à tela de bloqueio para usar um BackgroundTransferCompletionGroup.

Construtores

BackgroundTransferCompletionGroup()

Cria um novo objeto BackgroundTransferCompletionGroup .

Propriedades

IsEnabled	Obtém um valor que indica se o método Enable em um BackgroundTransferCompletionGroup já foi chamado.
Trigger	Obtém o IBackgroundTrigger usado para configurar a tarefa em segundo plano associada ao BackgroundTransferCompletionGroup.

Métodos

Enable()

Indica que BackgroundTransferCompletionGroup está concluído e não mais operações de transferência em segundo plano (objetos DownloadOperation ou UploadOperation ) serão adicionadas ao grupo de conclusão.

Confira também

• BackgroundTaskBuilder
• DownloadOperation
• IBackgroundTask
• UploadOperation