StorageFile.CreateStreamedFileAsync 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í.
Crea un storageFile para representar el flujo de datos especificado. 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 a storageFile que representa la secuencia por primera vez.
public:
static IAsyncOperation<StorageFile ^> ^ CreateStreamedFileAsync(Platform::String ^ displayNameWithExtension, StreamedFileDataRequestedHandler ^ dataRequested, IRandomAccessStreamReference ^ thumbnail);/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateStreamedFileAsync(winrt::hstring const& displayNameWithExtension, StreamedFileDataRequestedHandler const& dataRequested, IRandomAccessStreamReference const& thumbnail);[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateStreamedFileAsync(string displayNameWithExtension, StreamedFileDataRequestedHandler dataRequested, IRandomAccessStreamReference thumbnail);function createStreamedFileAsync(displayNameWithExtension, dataRequested, thumbnail)Public Shared Function CreateStreamedFileAsync (displayNameWithExtension As String, dataRequested As StreamedFileDataRequestedHandler, thumbnail As IRandomAccessStreamReference) As IAsyncOperation(Of StorageFile)Parámetros
- displayNameWithExtension
-
String
Platform::String
winrt::hstring
Nombre descriptivo del archivo StorageFile que se va a crear, incluida una extensión de tipo de archivo.
- dataRequested
- StreamedFileDataRequestedHandler
Función que se debe invocar cuando se obtiene acceso por primera vez al storageFile que se devuelve. Esta función debe generar el flujo de datos representado por el storageFile devuelto y permitir 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 la nueva secuencia de datos.
- Atributos
Comentarios
Tanto este método como CreateStreamedFileFromUriAsync se pueden usar para crear un StorageFile que se pueda pasar a otros métodos o pasar a otra aplicación a través de contratos de aplicación.
Estos métodos permiten aplazar operaciones costosas para generar los datos hasta que sean necesarios (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.