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 で表されるデータ ストリームを生成し、作成時にファイルの内容を書き込むのではなく、アプリがオンデマンドでデータを生成できるようにする必要があります。
- thumbnail
- IRandomAccessStreamReference
作成する StorageFile のサムネイル画像。
高品質のサムネイルの場合、このサムネイルの 1 つの端は少なくとも 1024 ピクセルである必要があります。
戻り値
このメソッドが完了すると、データの新しいストリームを表す StorageFile オブジェクトが返されます。
- 属性
注釈
このメソッドと CreateStreamedFileFromUriAsync の両方を使用して、他のメソッドに渡したり、アプリ コントラクトを介して別のアプリに渡したりできる StorageFile を作成できます。
これらのメソッドを使用すると、必要なデータ (最初にアクセスされたとき) まで、データを生成するためのコストのかかる操作を延期できます。 これにより、データの生成中にユーザーの操作に不要な遅延が生じるのを回避できます。