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 所代表的資料流程,並讓應用程式視需要產生資料,而不是在建立時寫入檔案的內容。
傳回
此方法完成時,它會傳回代表新資料流程的 StorageFile 物件。 接著,這個 StorageFile 物件應該用來存取檔案內容,而不是 (類型 IStorageFile) 指定取代的檔案。
- 屬性
備註
此方法可讓您延遲昂貴的作業,以產生資料,直到第一次存取資料時 (該資料) 為止。 這可避免在產生資料時產生使用者互動時產生不必要的延遲。