PageContent.GetPageRootAsync(Boolean) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

异步加载并返回 FixedPage 内容元素。

public:
 void GetPageRootAsync(bool forceReload);

public void GetPageRootAsync (bool forceReload);

member this.GetPageRootAsync : bool -> unit

Public Sub GetPageRootAsync (forceReload As Boolean)

如果为 true，则始终重新加载 FixedPage，即使先前已对其进行加载和缓存；如果为 false，则仅在没有缓存版本的情况下才加载 FixedPage。

GetPageRootAsync 异步加载和分析 FixedPage 与此 PageContent关联的数据流。完成时 GetPageRootAsync ，其他线程将继续运行。

以下步骤演示了如何异步加载 FixedPage 内容：

创建委托 GetPageRootCompletedEventHandler 并将其添加，以便收到事件通知 GetPageRootCompleted 。
调用 GetPageRootAsync。
GetPageRootCompleted事件发生并调用委托时，内容FixedPage已完成加载。加载的 FixedPage 元素通过 GetPageRootCompletedEventArgs属性Result 返回。

有关元素的详细信息 <PageContent> ，请参阅 XPS 规范的第 3 章，可在 XPS：规范和许可证下载中获取。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 GetPageRoot(Boolean)异常。