StorageFile.ReplaceWithStreamedFileAsync Metodo

Definizione

Spazio dei nomi:

Windows.Storage

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

IAsyncOperation<StorageFile>

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

RemoteAsyncAttribute

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.