StorageFile.ReplaceWithStreamedFileAsync Método

Definición

Espacio de nombres:

Windows.Storage

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

IAsyncOperation<StorageFile>

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

RemoteAsyncAttribute

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.