ReplaceWithStreamedFileAsync | replaceWithStreamedFileAsync - Methode
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern

StorageFile.ReplaceWithStreamedFileAsync | replaceWithStreamedFileAsync Method

Ersetzt den Inhalt der Datei, auf die durch das angegebene IStorageFile-Objekt verwiesen wird, durch einen neuen Datenstream. Mit dieser Methode kann die App Daten bei Bedarf erzeugen. Hierzu wird eine Funktion angegeben, die aufgerufen wird, wenn zum ersten Mal auf das StorageFile-Element zugegriffen wird, das den Datenstrom darstellt.

Syntax


Windows.Storage.StorageFile.replaceWithStreamedFileAsync(fileToReplace, dataRequested, thumbnail).done( /* Ihre Erfolgs -und Fehlerhandler */ );

Parameter

fileToReplace

Typ: IStorageFile

Die Datei (Typ IStorageFile), in die der neue Datenstrom geschrieben werden soll.

dataRequested

Typ: StreamedFileDataRequestedHandler

Die Funktion, die aufgerufen werden soll, wenn zum ersten Mal auf das zurückgegebene StorageFile-Element zugegriffen wird. Diese Funktion sollte den Datenstrom erzeugen, der vom zurückgegebenen StorageFile-Element dargestellt wird. Sie ermöglicht der App, Daten bei Bedarf zu erzeugen, anstatt den Inhalt der Datei zum Erstellungszeitpunkt zu schreiben.

thumbnail

Typ: IRandomAccessStreamReference

Die Miniaturansicht, die durch StorageFile erstellt werden soll.

Bei einer hochqualitativen Miniaturansicht sollte ein Rand dieser Miniaturansicht mindestens 1024 Pixel betragen.

Rückgabewert

Typ: IAsyncOperation<StorageFile>

Wenn diese Methode abgeschlossen ist, wird ein StorageFile-Objekt zurückgegeben, das den neuen Datenstrom darstellt. Anschließend sollte dieses StorageFile-Objekt verwendet werden, um auf den Dateiinhalt und nicht auf die Datei (Typ IStorageFile) zuzugreifen, die als zu ersetzende Datei angegeben wurde.

Anmerkungen

Mit dieser Methode können Sie aufwendige Vorgänge zum Erstellen von Daten verzögern, bis diese Daten benötigt werden (wenn auf sie zum ersten Mal zugegriffen wird). Dadurch werden beim Erstellen der Daten unnötige Verzögerungen in der Benutzerinteraktion vermieden.

Windows Phone 8

Diese API wird nicht implementiert und löst beim Aufruf eine Ausnahme aus. Weitere Informationen finden Sie unter Windows Phone Runtime API.

Anforderungen

Unterstützte Mindestversion (Client)

Windows 8

Unterstützte Mindestversion (Server)

Windows Server 2012

Unterstützte Mindestversion (Telefon)

Windows Phone 8 [nicht implementiert, siehe Hinweise]

Namespace

Windows.Storage
Windows::Storage [C++]

Metadaten

Windows.winmd

Weitere Informationen

StorageFile

 

 

Anzeigen:
© 2017 Microsoft