PageContent.GetPageRootAsync(Boolean) Метод

Определение

Асинхронная загрузка и возврат элемента содержимого FixedPage.

public:
 void GetPageRootAsync(bool forceReload);
public void GetPageRootAsync (bool forceReload);
member this.GetPageRootAsync : bool -> unit
Public Sub GetPageRootAsync (forceReload As Boolean)

Параметры

forceReload
Boolean

Значение true, чтобы всегда перезагружать объект FixedPage, даже если он был ранее загружен и кэширован; значение false, чтобы загружать FixedPage только в том случае, если отсутствует кэшированная версия.

Комментарии

GetPageRootAsync асинхронно загружает и анализирует поток данных, связанный FixedPage с данным PageContentобъектом . Другие потоки будут продолжать выполняться во время GetPageRootAsync завершения.

Ниже показано, как загрузить содержимое FixedPage асинхронно.

  1. GetPageRootCompletedEventHandler Создайте делегат и добавьте его для уведомления о событияхGetPageRootCompleted.

  2. Вызовите процедуру GetPageRootAsync.

  3. GetPageRootCompleted Когда происходит событие и вызывается делегат, загрузка содержимого FixedPage завершается. Загруженный FixedPage элемент возвращается через GetPageRootCompletedEventArgsсвойство .Result

Дополнительные сведения об элементе см. в <PageContent> главе 3 спецификации XPS, которую можно получить на странице XPS: Спецификация и скачиваемые лицензии.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые GetPageRoot(Boolean).

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

См. также раздел