StorageFile.ReplaceWithStreamedFileAsync 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.
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
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
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.