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), который был указан для замены.
- Атрибуты
Комментарии
Этот метод позволяет отложить ресурсоемкие операции для создания данных до тех пор, пока они не понадобятся (при первом обращении к ним). Это позволяет избежать ненужных задержек при взаимодействии с пользователем во время создания данных.