Erweitern Minimieren

StorageFile.CreateStreamedFileAsync | createStreamedFileAsync Method

Erstellt eine StorageFile-Datei, um den angegebenen Datenstream darzustellen. 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.createStreamedFileAsync(displayNameWithExtension, dataRequested, thumbnail).done( /* Ihre Erfolgs -und Fehlerhandler */ );

Parameter

displayNameWithExtension

Typ: String [JavaScript] | System.String [.NET] | Platform::String [C++]

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

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.

Anmerkungen

Sie können diese Methode verwenden, um eine StorageFile-Klasse zu erstellen, die Sie an andere Methoden übergeben können und die mithilfe von App-Verträgen an eine andere App weitergeleitet werden kann.

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:
© 2014 Microsoft