StorageFile.ReplaceWithStreamedFileAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.