PageContent.GetPageRootAsync(Boolean) Methode

Definition

Lädt asynchron das FixedPage Inhaltselement und gibt dieses zurück.

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

Parameter

forceReload
Boolean

true, um die FixedPage immer neu zu laden, auch wenn sie zuvor geladen und zwischengespeichert wurde. false, um die FixedPage nur zu laden, wenn keine zwischengespeicherte Version vorhanden ist.

Hinweise

GetPageRootAsyncLädt den diesem zugeordneten PageContentDatenstrom asynchron und analysiert diesenFixedPage. Andere Threads werden weiterhin ausgeführt, während GetPageRootAsync die Ausführung abgeschlossen ist.

Die folgenden Schritte veranschaulichen das asynchrone Laden des FixedPage Inhalts:

  1. Erstellen Sie einen GetPageRootCompletedEventHandler Delegaten, und fügen Sie ihn hinzu, um über Ereignisse benachrichtigt GetPageRootCompleted zu werden.

  2. Rufen Sie GetPageRootAsync auf.

  3. Wenn das GetPageRootCompleted Ereignis auftritt und der Delegat aufgerufen wird, wurde das Laden des FixedPage Inhalts abgeschlossen. Das geladene FixedPage Element wird über die GetPageRootCompletedEventArgsEigenschaft zurückgegeben.Result

Weitere Informationen zum <PageContent> Element finden Sie im Kapitel 3 der XPS-Spezifikation, das Sie unter XPS: Spezifikations- und Lizenzdownloads abrufen können.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden GetPageRoot(Boolean).

Gilt für:

Weitere Informationen