StorageFile.ReplaceWithStreamedFileAsync Methode
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.
Ersetzt den Inhalt der Datei, auf die durch das angegebene IStorageFile-Objekt verwiesen wird, durch einen neuen Datenstrom. Mit dieser Methode kann die App die Daten bei Bedarf erstellen, indem eine Funktion angegeben wird, die aufgerufen werden soll, wenn zuerst auf die StorageFile , die den Stream darstellt, zugegriffen wird.
public:
static IAsyncOperation<StorageFile ^> ^ ReplaceWithStreamedFileAsync(IStorageFile ^ fileToReplace, StreamedFileDataRequestedHandler ^ dataRequested, IRandomAccessStreamReference ^ thumbnail);/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> ReplaceWithStreamedFileAsync(IStorageFile const& fileToReplace, StreamedFileDataRequestedHandler const& dataRequested, IRandomAccessStreamReference const& thumbnail);[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> ReplaceWithStreamedFileAsync(IStorageFile fileToReplace, StreamedFileDataRequestedHandler dataRequested, IRandomAccessStreamReference thumbnail);function replaceWithStreamedFileAsync(fileToReplace, dataRequested, thumbnail)Public Shared Function ReplaceWithStreamedFileAsync (fileToReplace As IStorageFile, dataRequested As StreamedFileDataRequestedHandler, thumbnail As IRandomAccessStreamReference) As IAsyncOperation(Of StorageFile)- fileToReplace
- IStorageFile
Die Datei (Typ IStorageFile), in die der neue Datenstrom geschrieben werden soll.
- dataRequested
- StreamedFileDataRequestedHandler
Die Funktion, die aufgerufen werden soll, wenn zuerst auf die zurückgegebene StorageFile-Datei zugegriffen wird. Diese Funktion sollte den Datenstrom erzeugen, der durch die zurückgegebene StorageFile-Datei dargestellt wird, und die App kann Daten bei Bedarf erstellen, anstatt den Inhalt der Datei zum Zeitpunkt der Erstellung zu schreiben.
- thumbnail
- IRandomAccessStreamReference
Das Miniaturbild für die zu erstellende StorageFile.The thumbnail image for the StorageFile to create.
Für eine qualitativ hochwertige Miniaturansicht sollte ein Rand dieser Miniaturansicht mindestens 1.024 Pixel betragen.
Nach Abschluss dieser Methode wird ein StorageFile-Objekt zurückgegeben, das den neuen Datenstrom darstellt. Anschließend sollte dieses StorageFile-Objekt für den Zugriff auf Dateiinhalte anstelle der Datei (Typ IStorageFile) verwendet werden, die zum Ersetzen angegeben wurde.
- Attribute
Mit dieser Methode können Sie teure Vorgänge zurückstellen, um die Daten zu erzeugen, bis diese Daten benötigt werden (wenn zuerst darauf zugegriffen wird). Dadurch werden unnötige Verzögerungen bei der Benutzerinteraktion vermieden, während die Daten erzeugt werden.
| Produkt | Versionen |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |