Windows.Networking.BackgroundTransfer Пространство имен

Включает расширенные возможности загрузки и передачи данных в приложении. Общие сведения о возможностях фоновой передачи см. в разделе "Передача данных" в фоновом режиме. Скачайте пример фоновой передачи для примера кода.

Примечание

Фоновая передача в основном предназначена для долгосрочных операций передачи ресурсов, таких как видео, музыка и большие изображения. Для краткосрочных операций, связанных с передачей небольших ресурсов (т. е. пару КБ), рекомендуется использовать API HTTP. HttpClient предпочтительнее и может использоваться на всех языках, поддерживаемых приложениями UWP. XHR можно использовать в JavaScript. IXHR2 можно использовать в C++.

Классы

BackgroundDownloader

Используется для настройки загрузки до фактического создания операции скачивания с помощью CreateDownload. Общие сведения о возможностях фоновой передачи см. в разделе "Передача данных" в фоновом режиме. Скачайте пример фоновой передачи для примера кода.

Примечание

Фоновая передача в основном предназначена для долгосрочных операций передачи ресурсов, таких как видео, музыка и большие изображения. Для краткосрочных операций, связанных с передачей небольших ресурсов (т. е. пару КБ), используйте пространство имен Windows.Web.Http .

BackgroundTransferCompletionGroup

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

BackgroundTransferCompletionGroupTriggerDetails

Содержит сведения о BackgroundTransferCompletionGroup , доступ к которому можно получить только из метода Run в IBackgroundTask.

BackgroundTransferContentPart

Представляет часть содержимого многокомпонентного запроса на передачу. Каждый объект BackgroundTransferContentPart может представлять одну строку текстового содержимого или полезные данные одного файла, но не оба.

BackgroundTransferError

Используется для предоставления ошибок, возникающих во время операции передачи.

BackgroundTransferGroup

Именованной группой, используемой для связывания нескольких операций загрузки или отправки. Этот класс позволяет приложению легко создавать эти группы, а также выполнять скачивание и отправку одновременно, последовательно или на основе приоритета.

Например, если пользователь решает скачать и посмотреть эпизоды из популярной телевизионной серии, ваше приложение может определить приоритеты самых ранних эпизодов в серии или позволить пользователю выбрать, какой эпизод скачать первым.

BackgroundTransferRangesDownloadedEventArgs

Предоставляет доступ к сведениям о событии хода выполнения добавочного скачивания.

BackgroundUploader

Используется для настройки отправки до фактического создания операции отправки с помощью CreateUpload. Общие сведения о возможностях фоновой передачи см. в разделе "Передача данных" в фоновом режиме. Скачайте пример фоновой передачи для примера кода.

Примечание

Фоновая передача в основном предназначена для долгосрочных операций передачи ресурсов, таких как видео, музыка и большие изображения. Для краткосрочных операций, связанных с передачей небольших ресурсов (т. е. пару КБ), используйте пространство имен Windows.Web.Http .

ContentPrefetcher

Предоставляет свойства для указания предварительной выборки веб-ресурсов. Windows будет использовать эвристические средства, чтобы попытаться скачать указанные ресурсы до запуска приложения пользователем.

DownloadOperation

Выполняет асинхронную операцию загрузки. В примере фоновой передачи демонстрируется эта функция. Общие сведения о возможностях фоновой передачи см. в разделе "Передача данных" в фоновом режиме.

ResponseInformation

Представляет данные, возвращаемые ответом сервера.

UnconstrainedTransferRequestResult

Представляет результат запроса на передачу без ограничений из объекта BackgroundDownloader или BackgroundUploader .

Неограниченные операции передачи могут выполняться без ограничений ресурсов, обычно связанных с фоновыми сетевыми операциями, а устройство работает от батареи.

UploadOperation

Выполняет асинхронную операцию отправки. Общие сведения о возможностях фоновой передачи см. в разделе "Передача данных" в фоновом режиме. Скачайте пример фоновой передачи для примера кода.

Структуры

BackgroundDownloadProgress

Содержит сведения о состоянии операции скачивания.

BackgroundTransferFileRange

Содержит сведения о состоянии операции передачи файлов.

BackgroundUploadProgress

Содержит сведения о состоянии операции отправки.

Интерфейсы

IBackgroundTransferBase

Представляет операцию фоновой передачи.

IBackgroundTransferContentPartFactory

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

IBackgroundTransferOperation

Представляет операцию фоновой передачи.

IBackgroundTransferOperationPriority

Используйте этот интерфейс для определения приоритета загрузки или отправки в BackgroundTransferGroup. Возможные значения определяются перечислением BackgroundTransferPriority .

Перечисления

BackgroundTransferBehavior

Определяет значения, используемые для указания того, выполняются ли загрузки и передачи в BackgroundTransferGroup одновременно или последовательно.

BackgroundTransferCostPolicy

Определяет значения, используемые для указания возможности передачи данных в сетях с лимитным лимитом.

BackgroundTransferPriority

Указывает приоритет, который имеет операция BackgroundTransfer (скачивание или отправка) с точки зрения планирования в приложении.

BackgroundTransferStatus

Определяет значения состояния операции передачи.

Комментарии

На большинстве платформ фоновая передача будет продолжать передавать файлы (скачивать или отправлять), даже если приложение приостановлено или когда оно завершается. При запуске приложения необходимо вызвать BackgroundDownloader.GetCurrentDownloadsAsync или BackgroundUploader.GetCurrentUploadsAsync , чтобы перечислить все незавершенные передачи. Затем вызовите DownloadOperation.AttachAsync или UploadOperation.AttachAsync соответственно для каждого из них. Это позволяет получить последнее состояние передачи и привести к возобновлению передачи после перезагрузки системы. Если параметр DownloadOperation.IsRandomAccessRequired установленtrue, скачивание возобновляется автоматически после перезагрузки. В этом случае следует вызвать AttachAsync . Если приложение выполняется после завершения передачи (т. е. при возврате вызова AttachAsync ), можно выполнить работу в ответе. Кроме того, можно использовать BackgroundTransferCompletionGroup для запуска фоновой задачи после завершения передачи.

В Xbox фоновая передача передает только файлы (скачивание или отправка), пока приложение находится на переднем плане. Если приложение приостановлено, помещено в фон или завершилось, фоновые передачи приложения приостанавливаются. Когда приложение снова запускается на переднем плане, его передача возобновляется автоматически.

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