PageContent.GetPageRootAsync(Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic 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:
Erstellen Sie einen GetPageRootCompletedEventHandler Delegaten, und fügen Sie ihn hinzu, um über Ereignisse benachrichtigt GetPageRootCompleted zu werden.
Rufen Sie GetPageRootAsync auf.
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).
