StorageFile.ReplaceWithStreamedFileAsync Methode

Definition

Namespace:

Windows.Storage

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)

Parameter

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.

Gibt zurück

IAsyncOperation<StorageFile>

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

RemoteAsyncAttribute

Hinweise

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.