BackgroundDownloader.CreateDownloadAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает асинхронную операцию скачивания, которая включает универсальный код ресурса (URI), файл, в который будет записан ответ, и объект IInputStream , из которого считывается содержимое файла.
public:
virtual IAsyncOperation<DownloadOperation ^> ^ CreateDownloadAsync(Uri ^ uri, IStorageFile ^ resultFile, IInputStream ^ requestBodyStream) = CreateDownloadAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<DownloadOperation> CreateDownloadAsync(Uri const& uri, IStorageFile const& resultFile, IInputStream const& requestBodyStream);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<DownloadOperation> CreateDownloadAsync(System.Uri uri, IStorageFile resultFile, IInputStream requestBodyStream);function createDownloadAsync(uri, resultFile, requestBodyStream)Public Function CreateDownloadAsync (uri As Uri, resultFile As IStorageFile, requestBodyStream As IInputStream) As IAsyncOperation(Of DownloadOperation)Параметры
- resultFile
- IStorageFile
Представляет файл, в который будет записан ответ.
- requestBodyStream
- IInputStream
Поток, представляющий тело сущности запроса.
Возвращаемое значение
Результирующей асинхронной операции скачивания.
- Атрибуты
Комментарии
Фоновая передача не поддерживает одновременные загрузки одного и того же URI. Таким образом, приложение может скачать http://example.com/myfile.wmv один раз или скачать его снова после завершения предыдущей загрузки. Приложение не должно запускать две загрузки одного и того же URI одновременно, так как это может привести к усечению файлов.
Примечание
Некоторые файловые системы имеют ограничения на размер файлов. Фоновая передача данных имеет специальную логику для быстрой передачи данных со сбоем, которая превышает предельный размер файлов целевого диска (например, файлы, размер которого превышает 4 ГБ для файловых систем FAT32). Если сервер отвечает значением Content-Length заголовка, превышающим максимальный размер файла файловой системы, операция скачивания немедленно завершается ошибкой с HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_LIMITATION).