StorageFile.CreateStreamedFileAsync Méthode

Définition

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

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

Attributs

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.

S’applique à