BackgroundDownloader.CreateDownloadAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea una operación de descarga asincrónica que incluye un URI, el archivo en el que se escribirá la respuesta y el objeto IInputStream desde el que se lee el contenido del archivo.
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 el archivo en el que se escribirá la respuesta.
- requestBodyStream
- IInputStream
Secuencia que representa el cuerpo de la entidad de solicitud.
Devoluciones
La operación de descarga asincrónica resultante.
- Atributos
Comentarios
La transferencia en segundo plano no admite descargas simultáneas del mismo URI. Por lo tanto, una aplicación puede descargarla http://example.com/myfile.wmv una vez o volver a descargarla después de que se haya completado una descarga anterior. Una aplicación no debe iniciar dos descargas del mismo URI simultáneamente, ya que esto puede dar lugar a archivos truncados.
Nota
Algunos sistemas de archivos tienen límites de tamaño de archivo. La transferencia en segundo plano tiene una lógica especial para las transferencias de error rápido que superan los límites de tamaño de archivo de la unidad de destino (por ejemplo, archivos que superan los 4 GB de tamaño para los sistemas de archivos FAT32). Si el servidor responde con un Content-Length valor de encabezado mayor que el tamaño máximo de archivo del sistema de archivos, la operación de descarga produce un error inmediatamente con HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_LIMITATION).