PageContent.GetPageRootAsync(Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронная загрузка и возврат элемента содержимого FixedPage.
public:
void GetPageRootAsync(bool forceReload);public void GetPageRootAsync (bool forceReload);member this.GetPageRootAsync : bool -> unitPublic Sub GetPageRootAsync (forceReload As Boolean)Параметры
- forceReload
- Boolean
Значение true, чтобы всегда перезагружать объект FixedPage, даже если он был ранее загружен и кэширован; значение false, чтобы загружать FixedPage только в том случае, если отсутствует кэшированная версия.
Комментарии
GetPageRootAsync асинхронно загружает и анализирует поток данных, связанный FixedPage с данным PageContentобъектом . Другие потоки будут продолжать выполняться во время GetPageRootAsync завершения.
Ниже показано, как загрузить содержимое FixedPage асинхронно.
GetPageRootCompletedEventHandler Создайте делегат и добавьте его для уведомления о событияхGetPageRootCompleted.
Вызовите процедуру GetPageRootAsync.
GetPageRootCompleted Когда происходит событие и вызывается делегат, загрузка содержимого FixedPage завершается. Загруженный FixedPage элемент возвращается через GetPageRootCompletedEventArgsсвойство .Result
Дополнительные сведения об элементе см. в <PageContent> главе 3 спецификации XPS, которую можно получить на странице XPS: Спецификация и скачиваемые лицензии.
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые GetPageRoot(Boolean).
