StorageFile.CreateStreamedFileAsync Méthode

Définition

Espace de noms:

Windows.Storage

Crée un StorageFile pour représenter le flux de données spécifié. Cette méthode permet à l’application de produire les données à la demande en spécifiant une fonction à appeler lorsque le StorageFile qui représente le flux est utilisé pour la première fois.

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)

Paramètres

displayNameWithExtension

String

Platform::String

winrt::hstring

Nom convivial du StorageFile à créer, y compris une extension de type de fichier.

dataRequested

StreamedFileDataRequestedHandler

Fonction qui doit être appelée lors de la première consultation du StorageFile retourné. Cette fonction doit produire le flux de données représenté par le StorageFile retourné et permettre à l’application de produire des données à la demande au lieu d’écrire le contenu du fichier au moment de la création.

thumbnail

IRandomAccessStreamReference

Image miniature du StorageFile à créer.

Pour une miniature de haute qualité, un bord de cette miniature doit être d’au moins 1 024 pixels.

Retours

IAsyncOperation<StorageFile>

Une fois cette méthode terminée, elle retourne un objet StorageFile qui représente le nouveau flux de données.

Attributs

RemoteAsyncAttribute

Remarques

Cette méthode et CreateStreamedFileFromUriAsync peuvent être utilisés pour créer un StorageFile qui peut être passé à d’autres méthodes ou transmis à une autre application via des contrats d’application.

Ces méthodes vous permettent de différer les opérations coûteuses pour produire les données jusqu’à ce que ces données en ont besoin (lors de leur premier accès). Cela évite de créer des retards inutiles dans l’interaction de l’utilisateur pendant la production des données.