PageContent.GetPageRootAsync(Boolean) Méthode

Définition

Charge et retourne, de manière asynchrone, l'élément de contenu FixedPage.

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

Paramètres

forceReload
Boolean

true pour toujours recharger FixedPage même s’il a été précédemment chargé et mis en cache ; false pour charger FixedPage uniquement s’il n’existe aucune version mise en cache.

Remarques

GetPageRootAsync charge et analyse de manière asynchrone le flux de FixedPage données associé à ce PageContent. D’autres threads continueront à s’exécuter pendant la fin de l’exécution GetPageRootAsync .

Les étapes suivantes illustrent comment charger le FixedPage contenu de manière asynchrone :

  1. Créez un GetPageRootCompletedEventHandler délégué et ajoutez-le pour être informé des GetPageRootCompleted événements.

  2. Appelez GetPageRootAsync.

  3. Lorsque l’événement GetPageRootCompleted se produit et que le délégué est appelé, le chargement du FixedPage contenu est terminé. L’élément chargé FixedPage est retourné par le biais de la GetPageRootCompletedEventArgspropriété .Result

Pour plus d’informations sur l’élément, consultez le <PageContent> chapitre 3 de la spécification XPS que vous pouvez obtenir dans XPS : Spécification et téléchargements de licences.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par GetPageRoot(Boolean).

S’applique à

Voir aussi