PageContent.GetPageRootAsync(Boolean) メソッド

  • リファレンス

定義

名前空間:
System.Windows.Documents
アセンブリ:
PresentationFramework.dll

FixedPage コンテンツ要素を非同期に読み込んで返します。

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

パラメーター

forceReload
Boolean

FixedPage が以前に読み込まれ、キャッシュされていても、常に再読み込みする場合は、true。キャッシュ バージョンが存在しないときにのみ、FixedPage を読み込む場合は、false。

注釈

GetPageRootAsyncこの PageContentに関連付けられているデータ ストリームを非同期的にFixedPage読み込んで解析します。 他のスレッドは、完了時 GetPageRootAsync に引き続き実行されます。

次の手順は、コンテンツを非同期的に読み込む方法を FixedPage 示しています。

  1. デリゲートを GetPageRootCompletedEventHandler 作成し、イベントの GetPageRootCompleted 通知を受け取るために追加します。

  2. GetPageRootAsync を呼び出します。

  3. イベントが GetPageRootCompleted 発生し、デリゲートが呼び出されると、コンテンツの FixedPage 読み込みが完了しました。 読み込まれたFixedPage要素は、 プロパティをResultGetPageRootCompletedEventArgs介して返されます。

要素の <PageContent> 詳細については、「 XPS: 仕様とライセンスのダウンロード」で取得できる XPS 仕様の第 3 章を参照してください。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって GetPageRoot(Boolean)スローされる例外に関するページを参照してください。

適用対象

こちらもご覧ください