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 の同時ダウンロードはサポートされていません。 そのため、アプリは 1 回ダウンロード http://example.com/myfile.wmv することも、以前のダウンロードが完了した後にもう一度ダウンロードすることもできます。 アプリでは、同じ Uri の 2 つのダウンロードを同時に開始しないでください。これは、ファイルが切り捨てられる可能性があるためです。

Note

一部のファイル システムには、ファイル サイズの制限があります。 バックグラウンド転送には、転送先ドライブのファイル サイズ制限 (FAT32 ファイル システムのサイズが 4 GB を超えるファイルなど) を超える高速失敗転送に対する特別なロジックがあります。 サーバーがファイル システムの最大ファイル サイズを超えるヘッダー値で Content-Length 応答した場合、ダウンロード操作は直ちに HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_LIMITATION) で失敗します。

こちらもご覧ください

• IStorageFile
• IInputStream