StorageFile.ReplaceWithStreamedFileAsync 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.
Remplace le contenu du fichier auquel fait référence l’objet IStorageFile spécifié par un nouveau flux de données. Cette méthode permet à l’application de produire les données à la demande en spécifiant une fonction à appeler lors de la première consultation du StorageFile qui représente le flux.
public:
static IAsyncOperation<StorageFile ^> ^ ReplaceWithStreamedFileAsync(IStorageFile ^ fileToReplace, StreamedFileDataRequestedHandler ^ dataRequested, IRandomAccessStreamReference ^ thumbnail);
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> ReplaceWithStreamedFileAsync(IStorageFile const& fileToReplace, StreamedFileDataRequestedHandler const& dataRequested, IRandomAccessStreamReference const& thumbnail);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> ReplaceWithStreamedFileAsync(IStorageFile fileToReplace, StreamedFileDataRequestedHandler dataRequested, IRandomAccessStreamReference thumbnail);
function replaceWithStreamedFileAsync(fileToReplace, dataRequested, thumbnail)
Public Shared Function ReplaceWithStreamedFileAsync (fileToReplace As IStorageFile, dataRequested As StreamedFileDataRequestedHandler, thumbnail As IRandomAccessStreamReference) As IAsyncOperation(Of StorageFile)
Paramètres
- fileToReplace
- IStorageFile
Fichier (type IStorageFile) dans lequel le nouveau flux de données doit être écrit.
- 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 permet à 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 pour le 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. Par la suite, cet objet StorageFile doit être utilisé pour accéder au contenu du fichier au lieu du fichier (type IStorageFile) spécifié à remplacer.
- Attributs
Remarques
Cette méthode vous permet de différer les opérations coûteuses pour produire les données jusqu’à ce que ces données soient nécessaires (lors de leur premier accès). Cela évite de créer des retards inutiles dans l’interaction utilisateur pendant la production des données.