StorageFile.ReplaceWithStreamedFileAsync Método

Definição

Namespace:

Windows.Storage

Substitui o conteúdo do arquivo referenciado pelo objeto IStorageFile especificado por um novo fluxo de dados. 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 ^> ^ 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

O arquivo (tipo IStorageFile) no qual o novo fluxo de dados deve ser gravado.

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 ter 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. Posteriormente, esse objeto StorageFile deve ser usado para acessar o conteúdo do arquivo em vez do arquivo (tipo IStorageFile) que foi especificado para ser substituído.

Atributos

RemoteAsyncAttribute

Comentários

Esse método permite adiar operações caras para produzir os dados até que os 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.