Поделиться через

BackgroundTransferCompletionGroup Класс

  • Ссылка

Определение

Пространство имен:
Windows.Networking.BackgroundTransfer
Изменить

Представляет набор фоновых операций передачи (объекты DownloadOperation или UploadOperation ), которые запускают фоновую задачу после выполнения всех операций (если операции успешно завершены) или завершаются ошибкой.

public ref class BackgroundTransferCompletionGroup sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class BackgroundTransferCompletionGroup final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class BackgroundTransferCompletionGroup
[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
Наследование
Object Platform::Object IInspectable BackgroundTransferCompletionGroup
Атрибуты
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Класс BackgroundTransferCompletionGroup позволяет приложению регистрироваться для получения немедленного уведомления после завершения фоновых операций передачи, даже если приложение находится не на переднем плане. Приложение регистрирует фоновую задачу для получения уведомления, которое возникает в случае успешного завершения фоновой передачи данных или при возникновении ошибки. Это позволяет приложению немедленно получать уведомления во время завершения, а не требовать от приложения ожидания до следующего перезапуска приложения или перемещения на передний план для запроса завершения.

Приложение должно реализовать IBackgroundTask для запуска, получающего уведомления о завершении. IBackgroundTask необходимо зарегистрировать с помощью класса BackgroundTaskBuilder. Если для настройки задачи используется BackgroundTransferCompletionGroup.Trigger , инфраструктура брокера автоматически отменит ее регистрацию сразу после активации, поэтому нет необходимости в явном коде отмены регистрации задачи.

Фоновая задача должна быть объявлена в манифесте приложения. Приложению не требуется доступ к экрану блокировки для использования BackgroundTransferCompletionGroup.

Конструкторы

BackgroundTransferCompletionGroup()

Создает объект BackgroundTransferCompletionGroup .

Свойства

IsEnabled

Возвращает значение, указывающее, был ли уже вызван метод Enableв BackgroundTransferCompletionGroup .
Trigger

Возвращает IBackgroundTrigger , используемый для настройки фоновой задачи, связанной с BackgroundTransferCompletionGroup.

Методы

Enable()

Указывает, что backgroundTransferCompletionGroup завершена и никакие дополнительные фоновые операции передачи (объекты DownloadOperation или UploadOperation ) не будут добавлены в группу завершения.

Применяется к

См. также раздел