StorageFile.CreateStreamedFileAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.