StorageFile.CreateStreamedFileAsync 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 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
Nach Abschluss dieser Methode wird ein StorageFile-Objekt zurückgegeben, das den neuen Datenstrom darstellt.
- Attribute
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.