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