StorageFile.ReplaceWithStreamedFileAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将指定的 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 表示的数据流,并允许应用按需生成数据,而不是在创建时写入文件的内容。
返回
此方法完成后,它将返回一个 StorageFile 对象,该对象表示新的数据流。 随后,应使用此 StorageFile 对象来访问文件内容,而不是 (指定替换的 IStorageFile) 类型的文件。
- 属性
注解
通过此方法,可以推迟成本高昂的操作来生成数据,直到) 首次访问数据时需要该数据 (。 这可避免在生成数据时在用户交互中造成不必要的延迟。