BackgroundDownloader.CreateDownloadAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma operação de download assíncrona que inclui um URI, o arquivo no qual a resposta será gravada e o objeto IInputStream do qual o conteúdo do arquivo é lido.
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)Parâmetros
- resultFile
- IStorageFile
Representa o arquivo no qual a resposta será gravada.
- requestBodyStream
- IInputStream
Um fluxo que representa o corpo da entidade de solicitação.
Retornos
A operação de download assíncrona resultante.
- Atributos
Comentários
A transferência em segundo plano não dá suporte a downloads simultâneos do mesmo Uri. Portanto, um aplicativo pode baixar http://example.com/myfile.wmv uma vez ou baixá-lo novamente após a conclusão de um download anterior. Um aplicativo não deve iniciar dois downloads do mesmo Uri simultaneamente, pois isso pode resultar em arquivos truncados.
Observação
Alguns sistemas de arquivos têm limites de tamanho de arquivo. A transferência em segundo plano tem lógica especial para fazer failover rápido de transferências que excedem os limites de tamanho de arquivo da unidade de destino (por exemplo, arquivos que excedem 4 GB de tamanho para sistemas de arquivos FAT32). Se o servidor responder com um Content-Length valor de cabeçalho maior que o tamanho máximo do arquivo do sistema de arquivos, a operação de download falhará imediatamente com HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_LIMITATION).