BackgroundDownloader.CreateDownloadAsync 方法

定义

命名空间:

Windows.Networking.BackgroundTransfer

创建异步下载操作，其中包括 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)

参数

uri

Uri Uri

资源的位置。

resultFile

IStorageFile

表示将写入响应的文件。

requestBodyStream

IInputStream

表示请求实体正文的流。

返回

IAsyncOperation<DownloadOperation>

生成的异步下载操作。

属性

RemoteAsyncAttribute

注解

后台传输不支持同一 URI 的并发下载。 因此，应用可以下载 http://example.com/myfile.wmv 一次，也可以在完成之前的下载后再次下载。 应用不应同时启动同一 Uri 的两次下载，因为这可能会导致文件被截断。

注意

某些文件系统有文件大小限制。 后台传输具有特殊的逻辑来快速失败超过目标驱动器文件大小限制的传输， (例如，对于 FAT32 文件系统，超过 4GB 的文件) 。 如果服务器响应 Content-Length 的标头值大于文件系统的最大文件大小，则下载操作会立即失败并HRESULT_FROM_WIN32 (ERROR_FILE_SYSTEM_LIMITATION) 。

另请参阅

• IStorageFile
• IInputStream