StorageFile.ReplaceWithStreamedFileAsync 方法

  • 参考

定义

命名空间:
Windows.Storage
编辑

将指定的 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 像素。

返回

IAsyncOperation<StorageFile>

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

属性
RemoteAsyncAttribute

注解

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

适用于