StorageFile.CreateStreamedFileAsync メソッド

定義

名前空間:

Windows.Storage

指定したデータ ストリームを表す 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 のサムネイル画像。

高品質のサムネイルの場合、このサムネイルの 1 つの端は少なくとも 1024 ピクセルである必要があります。

戻り値

IAsyncOperation<StorageFile>

このメソッドが完了すると、データの新しいストリームを表す StorageFile オブジェクトが返されます。

属性

RemoteAsyncAttribute

注釈

このメソッドと CreateStreamedFileFromUriAsync の両方を使用して、他のメソッドに渡したり、アプリ コントラクトを介して別のアプリに渡したりできる StorageFile を作成できます。

これらのメソッドを使用すると、必要なデータ (最初にアクセスされたとき) まで、データを生成するためのコストのかかる操作を延期できます。 これにより、データの生成中にユーザーの操作に不要な遅延が生じるのを回避できます。