StorageFile.CreateStreamedFileAsync Methode

Definition

Namespace:

Windows.Storage

Erstellt eine StorageFile-Datei , die den angegebenen Datenstrom darstellt. 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 ^> ^ CreateStreamedFileAsync(Platform::String ^ displayNameWithExtension, StreamedFileDataRequestedHandler ^ dataRequested, IRandomAccessStreamReference ^ thumbnail);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateStreamedFileAsync(winrt::hstring const& displayNameWithExtension, StreamedFileDataRequestedHandler const& dataRequested, IRandomAccessStreamReference const& thumbnail);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateStreamedFileAsync(string displayNameWithExtension, StreamedFileDataRequestedHandler dataRequested, IRandomAccessStreamReference thumbnail);

function createStreamedFileAsync(displayNameWithExtension, dataRequested, thumbnail)

Public Shared Function CreateStreamedFileAsync (displayNameWithExtension As String, dataRequested As StreamedFileDataRequestedHandler, thumbnail As IRandomAccessStreamReference) As IAsyncOperation(Of StorageFile)

Parameter

displayNameWithExtension

String

Platform::String

winrt::hstring

Der benutzerfreundliche Name der zu erstellenden StorageFile-Datei , einschließlich einer Dateityperweiterung.

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.

Attribute

RemoteAsyncAttribute

Hinweise

Sowohl diese Methode als auch CreateStreamedFileFromUriAsync können verwendet werden, um eine StorageFile-Datei zu erstellen, die an andere Methoden übergeben oder über App-Verträge an eine andere App übergeben werden kann.

Mit diesen Methoden können Sie teure Vorgänge zurückstellen, um die Daten zu erzeugen, bis diese Daten benötigt werden (wenn sie zum ersten Mal zugegriffen werden). Dadurch werden unnötige Verzögerungen bei der Benutzerinteraktion vermieden, während die Daten erzeugt werden.