次の方法で共有


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)

パラメーター

uri
Uri Uri

リソースの場所。

resultFile
IStorageFile

応答の書き込み対象となるファイルを表します。

requestBodyStream
IInputStream

要求エンティティ本文を表すストリーム。

戻り値

結果の非同期ダウンロード操作。

属性

注釈

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

Note

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

適用対象

こちらもご覧ください