BackgroundDownloader.CreateDownloadAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt einen asynchronen Downloadvorgang, der einen URI, die Datei, in die die Antwort geschrieben wird, und das IInputStream-Objekt enthält, aus dem die Dateiinhalte gelesen werden.
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)Parameter
- resultFile
- IStorageFile
Stellt die Datei dar, in die die Antwort geschrieben wird.
- requestBodyStream
- IInputStream
Ein Stream, der den Anforderungsentitätstext darstellt.
Gibt zurück
Der resultierende asynchrone Downloadvorgang.
- Attribute
Hinweise
Die Hintergrundübertragung unterstützt keine gleichzeitigen Downloads desselben URI. Eine App kann also einmal heruntergeladen http://example.com/myfile.wmv oder erneut heruntergeladen werden, nachdem ein vorheriger Download abgeschlossen ist. Eine App sollte nicht zwei Downloads desselben URI gleichzeitig starten, da dies zu abgeschnittenen Dateien führen kann.
Hinweis
Einige Dateisysteme weisen Dateigrößenbeschränkungen auf. Die Hintergrundübertragung verfügt über eine spezielle Logik für schnelle Fehlerübertragungen, die die Dateigrößengrenzwerte des Ziellaufwerks überschreiten (z. B. Dateien, die eine Größe von mehr als 4 GB für FAT32-Dateisysteme überschreiten). Wenn der Server mit einem Content-Length Headerwert antwortet, der größer als die maximale Dateigröße des Dateisystems ist, schlägt der Downloadvorgang sofort mit HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_LIMITATION) fehl.