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


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

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

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

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 передача данных в фоновом режиме передает файлы (скачивание или отправку), пока приложение находится на переднем плане. Если приложение приостановлено, помещено в фоновый режим или завершено, фоновые передачи приложения приостанавливаются. Когда приложение снова запустится на переднем плане, его передача возобновляется автоматически.

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