StorageFile.ReplaceWithStreamedFileAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Reemplaza el contenido del archivo al que hace referencia el objeto IStorageFile especificado por una nueva secuencia de datos. Este método permite a la aplicación generar los datos a petición especificando una función que se va a invocar cuando se accede por primera vez al objeto StorageFile que representa la secuencia.
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)Parámetros
- fileToReplace
- IStorageFile
Archivo (tipo IStorageFile) en el que se debe escribir el nuevo flujo de datos.
- dataRequested
- StreamedFileDataRequestedHandler
Función que se debe invocar cuando se accede por primera vez al storageFile que se devuelve. Esta función debe generar el flujo de datos representado por el StorageFile devuelto y permite que la aplicación genere datos a petición en lugar de escribir el contenido del archivo en el momento de la creación.
- thumbnail
- IRandomAccessStreamReference
Imagen en miniatura de StorageFile que se va a crear.
Para una miniatura de alta calidad, un borde de esta miniatura debe ser de al menos 1024 píxeles.
Devoluciones
Cuando se completa este método, devuelve un objeto StorageFile que representa el nuevo flujo de datos. Posteriormente, este objeto StorageFile se debe usar para tener acceso al contenido del archivo en lugar del archivo (tipo IStorageFile) que se especificó para reemplazar.
- Atributos
Comentarios
Este método permite aplazar operaciones costosas para generar los datos hasta que se necesiten esos datos (cuando se accede por primera vez). Esto evita la creación de retrasos innecesarios en la interacción del usuario mientras se generan los datos.