BackgroundTransferCompletionGroup Clase

Definición

Espacio de nombres:

Windows.Networking.BackgroundTransfer

Representa un conjunto de operaciones de transferencia en segundo plano (objetos DownloadOperation o UploadOperation ) que desencadenan una tarea en segundo plano una vez realizadas todas las operaciones (si las operaciones se completan correctamente) o producen un error.

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

Herencia

Object Platform::Object IInspectable BackgroundTransferCompletionGroup

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La clase BackgroundTransferCompletionGroup permite que una aplicación se registre para recibir una notificación inmediata una vez completadas las operaciones de transferencia en segundo plano, incluso si la aplicación no está en primer plano. La aplicación registra una tarea en segundo plano para recibir una notificación que se produce si las transferencias en segundo plano se completaron correctamente o si se produjo un error. Esto permite que la aplicación se notifique inmediatamente en el momento de la finalización, en lugar de requerir que la aplicación espere hasta la próxima vez que se reinicie o se mueva a primer plano para consultar las finalizaciones.

La aplicación debe implementar IBackgroundTask para que se ejecute que reciba las notificaciones de finalización. IBackgroundTask debe registrarse con la clase BackgroundTaskBuilder. Cuando BackgroundTransferCompletionGroup.Trigger se usa para configurar la tarea, la infraestructura de Broker anulará automáticamente el registro en cuanto se desencadene, por lo que no es necesario tener ningún código explícito de anulación del registro de tareas.

La tarea en segundo plano debe declararse en el manifiesto de la aplicación. La aplicación no requiere acceso a la pantalla de bloqueo para usar backgroundTransferCompletionGroup.

Constructores

BackgroundTransferCompletionGroup()

Crea un nuevo objeto BackgroundTransferCompletionGroup .

Propiedades

IsEnabled	Obtiene un valor que indica si ya se ha llamado al método Enable en backgroundTransferCompletionGroup .
Trigger	Obtiene el IBackgroundTrigger usado para configurar la tarea en segundo plano asociada con BackgroundTransferCompletionGroup.

Métodos

Enable()

Indica que backgroundTransferCompletionGroup está completo y no se agregarán más operaciones de transferencia en segundo plano (objetos DownloadOperation o UploadOperation ) al grupo de finalización.

Consulte también

• BackgroundTaskBuilder
• DownloadOperation
• IBackgroundTask
• UploadOperation