StorageFile.CreateStreamedFileAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Quando esse método for concluído, ele retornará um objeto StorageFile que representa o novo fluxo de dados.
- Atributos
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.