StorageFile.ReplaceWithStreamedFileAsync メソッド

定義

名前空間:

Windows.Storage

指定した 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 ピクセルである必要があります。

戻り値

IAsyncOperation<StorageFile>

このメソッドが完了すると、新しいデータ ストリームを表す StorageFile オブジェクトが返されます。 その後、この StorageFile オブジェクトを使用して、置き換えるために指定されたファイル (タイプ IStorageFile) ではなく、ファイルの内容にアクセスする必要があります。

属性

RemoteAsyncAttribute

注釈

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