StorageFile.CreateStreamedFileAsync Método

Definición

Espacio de nombres:

Windows.Storage

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

IAsyncOperation<StorageFile>

Cuando se completa este método, devuelve un objeto StorageFile que representa la nueva secuencia de datos.

Atributos

RemoteAsyncAttribute

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.