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 的縮圖影像。

針對高品質的縮圖，此縮圖的一個邊緣至少應為 1024 圖元。

傳回

IAsyncOperation<StorageFile>

此方法完成時，它會傳回代表新資料流程的 StorageFile 物件。 接著，這個 StorageFile 物件應該用來存取檔案內容，而不是 (類型 IStorageFile) 指定取代的檔案。

屬性
RemoteAsyncAttribute

備註

此方法可讓您延遲昂貴的作業，以產生資料，直到第一次存取資料時 (該資料) 為止。 這可避免在產生資料時產生使用者互動時產生不必要的延遲。

適用於