Condividi tramite


StorageFile.ReplaceWithStreamedFileAsync Metodo

Definizione

Sostituisce il contenuto del file a cui fa riferimento l'oggetto IStorageFile specificato con un nuovo flusso di dati. Questo metodo consente all'app di produrre i dati su richiesta specificando una funzione da richiamare quando si accede per la prima volta a StorageFile che rappresenta il flusso.

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)

Parametri

fileToReplace
IStorageFile

File (tipo IStorageFile) in cui deve essere scritto il nuovo flusso di dati.

dataRequested
StreamedFileDataRequestedHandler

Funzione che deve essere richiamata quando si accede per la prima volta a StorageFile restituito. Questa funzione deve produrre il flusso di dati rappresentato da StorageFile restituito e consente all'app di produrre dati su richiesta anziché scrivere il contenuto del file in fase di creazione.

thumbnail
IRandomAccessStreamReference

Immagine di anteprima per StorageFile da creare.

Per un'anteprima di alta qualità, un bordo di questa anteprima deve essere di almeno 1024 pixel.

Restituisce

Al termine di questo metodo, restituisce un oggetto StorageFile che rappresenta il nuovo flusso di dati. Successivamente, questo oggetto StorageFile deve essere usato per accedere al contenuto del file anziché al file (tipo IStorageFile) che è stato specificato per la sostituzione.

Attributi

Commenti

Questo metodo consente di rinviare le operazioni dispendiose per produrre i dati fino a quando non sono necessari (quando si accede per la prima volta). In questo modo si evitano ritardi non necessari durante l'interazione dell'utente durante la produzione dei dati.

Si applica a