StorageFile.CreateStreamedFileAsync 方法

定义

创建一个 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 表示的数据流,并允许应用按需生成数据,而不是在创建时写入文件的内容。

thumbnail
IRandomAccessStreamReference

要创建的 StorageFile 的缩略图。

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

返回

此方法完成后,它将返回一个 StorageFile 对象,该对象表示新的数据流。

属性

注解

此方法和 CreateStreamedFileFromUriAsync 都可用于创建可传递给其他方法或通过应用协定传递给其他应用的 StorageFile

这些方法使你能够将生成数据的开销高昂的操作推迟到) 首次访问数据时 (该数据。 这可避免在生成数据时在用户交互中造成不必要的延迟。

适用于