StorageFile.CreateStreamedFileAsync Метод

Определение

Пространство имен:

Windows.Storage

Создает Объект StorageFile для представления указанного потока данных. Этот метод позволяет приложению создавать данные по запросу, указывая функцию, которая будет вызываться при первом доступе к файлу StorageFile , представляющего поток.

public:
 static IAsyncOperation<StorageFile ^> ^ CreateStreamedFileAsync(Platform::String ^ displayNameWithExtension, StreamedFileDataRequestedHandler ^ dataRequested, IRandomAccessStreamReference ^ thumbnail);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateStreamedFileAsync(winrt::hstring const& displayNameWithExtension, StreamedFileDataRequestedHandler const& dataRequested, IRandomAccessStreamReference const& thumbnail);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateStreamedFileAsync(string displayNameWithExtension, StreamedFileDataRequestedHandler dataRequested, IRandomAccessStreamReference thumbnail);

function createStreamedFileAsync(displayNameWithExtension, dataRequested, thumbnail)

Public Shared Function CreateStreamedFileAsync (displayNameWithExtension As String, dataRequested As StreamedFileDataRequestedHandler, thumbnail As IRandomAccessStreamReference) As IAsyncOperation(Of StorageFile)

Параметры

displayNameWithExtension

String

Platform::String

winrt::hstring

Понятное имя создаваемого файла StorageFile , включая расширение типа файла.

dataRequested

StreamedFileDataRequestedHandler

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

thumbnail

IRandomAccessStreamReference

Эскиз создаваемого файла StorageFile .

Для высококачественного эскиза один край этого эскиза должен быть не менее 1024 пикселей.

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

IAsyncOperation<StorageFile>

После завершения этого метода возвращается объект StorageFile , представляющий новый поток данных.

Атрибуты

RemoteAsyncAttribute

Комментарии

Этот метод и CreateStreamedFileFromUriAsync можно использовать для создания файла StorageFile , который можно передать другим методам или передать другому приложению через контракты приложения.

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