StorageFile.ReplaceWithStreamedFileAsync Méthode

Définition

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.

S’applique à