StorageFile.CreateStreamedFileAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建一个 StorageFile 来表示指定的数据流。 此方法允许应用通过指定要在首次访问表示流的 StorageFile 时调用的函数来按需生成数据。
public:
static IAsyncOperation<StorageFile ^> ^ CreateStreamedFileAsync(Platform::String ^ displayNameWithExtension, StreamedFileDataRequestedHandler ^ dataRequested, IRandomAccessStreamReference ^ thumbnail);
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateStreamedFileAsync(winrt::hstring const& displayNameWithExtension, StreamedFileDataRequestedHandler const& dataRequested, IRandomAccessStreamReference const& thumbnail);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateStreamedFileAsync(string displayNameWithExtension, StreamedFileDataRequestedHandler dataRequested, IRandomAccessStreamReference thumbnail);
function createStreamedFileAsync(displayNameWithExtension, dataRequested, thumbnail)
Public Shared Function CreateStreamedFileAsync (displayNameWithExtension As String, dataRequested As StreamedFileDataRequestedHandler, thumbnail As IRandomAccessStreamReference) As IAsyncOperation(Of StorageFile)
参数
- displayNameWithExtension
-
String
Platform::String
winrt::hstring
要创建的 StorageFile 的用户友好名称,包括文件类型扩展名。
- dataRequested
- StreamedFileDataRequestedHandler
首次访问返回的 StorageFile 时应调用的函数。 此函数应生成由返回的 StorageFile 表示的数据流,并允许应用按需生成数据,而不是在创建时写入文件的内容。
返回
此方法完成后,它将返回一个 StorageFile 对象,该对象表示新的数据流。
- 属性
注解
此方法和 CreateStreamedFileFromUriAsync 都可用于创建可传递给其他方法或通过应用协定传递给其他应用的 StorageFile 。
这些方法使你能够将生成数据的开销高昂的操作推迟到) 首次访问数据时 (该数据。 这可避免在生成数据时在用户交互中造成不必要的延迟。