Поделиться через


StorageFile.ReplaceWithStreamedFileAsync Метод

Определение

Заменяет содержимое файла, на который ссылается указанный объект 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 пикселей.

Возвращаемое значение

После завершения этого метода возвращается объект StorageFile , представляющий новый поток данных. Впоследствии этот объект StorageFile следует использовать для доступа к содержимому файла вместо файла (тип IStorageFile), который был указан для замены.

Атрибуты

Комментарии

Этот метод позволяет отложить ресурсоемкие операции для создания данных до тех пор, пока они не понадобятся (при первом обращении к ним). Это позволяет избежать ненужных задержек при взаимодействии с пользователем во время создания данных.

Применяется к