StorageFile.CreateStreamedFileAsync Método

Definição

Namespace:

Windows.Storage

Cria um StorageFile para representar o fluxo de dados especificado. Esse método permite que o aplicativo produza os dados sob demanda especificando uma função a ser invocada quando o StorageFile que representa o fluxo for acessado pela primeira 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

O nome amigável do StorageFile a ser criado, incluindo uma extensão de tipo de arquivo.

dataRequested

StreamedFileDataRequestedHandler

A função que deve ser invocada quando o StorageFile retornado é acessado pela primeira vez. Essa função deve produzir o fluxo de dados representado pelo StorageFile retornado e permite que o aplicativo produza dados sob demanda em vez de gravar o conteúdo do arquivo no momento da criação.

thumbnail

IRandomAccessStreamReference

A imagem em miniatura do StorageFile a ser criado.

Para uma miniatura de alta qualidade, uma borda dessa miniatura deve ser de pelo menos 1024 pixels.

Retornos

IAsyncOperation<StorageFile>

Quando esse método for concluído, ele retornará um objeto StorageFile que representa o novo fluxo de dados.

Atributos

RemoteAsyncAttribute

Comentários

Esse método e CreateStreamedFileFromUriAsync podem ser usados para criar um StorageFile que pode ser passado para outros métodos ou passado para outro aplicativo por meio de contratos de aplicativo.

Esses métodos permitem adiar operações caras para produzir os dados até que esses dados sejam necessários (quando eles são acessados pela primeira vez). Isso evita a criação de atrasos desnecessários na interação do usuário enquanto os dados são produzidos.