StorageFile.ReplaceWithStreamedFileAsync 方法

定义

将指定的 IStorageFile 对象引用的文件的内容替换为新的数据流。 此方法允许应用通过指定要在首次访问表示流的 StorageFile 时调用的函数来按需生成数据。

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)

参数

fileToReplace
IStorageFile

文件 (应写入新数据流) 类型 IStorageFile

dataRequested
StreamedFileDataRequestedHandler

首次访问返回的 StorageFile 时应调用的函数。 此函数应生成由返回的 StorageFile 表示的数据流,并允许应用按需生成数据,而不是在创建时写入文件的内容。

thumbnail
IRandomAccessStreamReference

要创建的 StorageFile 的缩略图。

对于高质量缩略图,此缩略图的一个边缘应至少为 1024 像素。

返回

此方法完成后,它将返回一个 StorageFile 对象,该对象表示新的数据流。 随后,应使用此 StorageFile 对象来访问文件内容,而不是 (指定替换的 IStorageFile) 类型的文件。

属性

注解

通过此方法,可以推迟成本高昂的操作来生成数据,直到) 首次访问数据时需要该数据 (。 这可避免在生成数据时在用户交互中造成不必要的延迟。

适用于