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 檔案系統的大小超過 4 GB 的檔案) 。 如果伺服器以大於檔案系統檔案大小上限的標頭值回應 Content-Length ，則下載作業會立即失敗並HRESULT_FROM_WIN32 (ERROR_FILE_SYSTEM_LIMITATION) 。

另請參閱

• IStorageFile
• IInputStream