BackgroundDownloader.CreateDownloadAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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 의 두 다운로드를 동시에 시작해서는 안 됩니다.
참고
일부 파일 시스템에는 파일 크기 제한이 있습니다. 백그라운드 전송에는 대상 드라이브의 파일 크기 제한(예: FAT32 파일 시스템의 크기가 4GB를 초과하는 파일)을 초과하는 빠른 전송에 대한 특별한 논리가 있습니다. 서버가 파일 시스템의 최대 파일 크기보다 큰 헤더 값으로 Content-Length 응답하면 HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_LIMITATION)으로 다운로드 작업이 즉시 실패합니다.