DynamicDocumentPaginator.GetPageNumberAsync Méthode

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition)

Paramètres

Remarques

La seule façon d’annuler l’opération asynchrone de cette méthode consiste à annuler toutes les opérations asynchrones. Contrastez-le avec l’autre surcharge de cette méthode : GetPageNumberAsync(ContentPosition, Object).

Cette méthode déclenche l’événement GetPageNumberCompleted. Le numéro de page est passé à l’événement en tant qu’arguments d’événement. Consultez GetPageNumberAsync(ContentPosition, Object) pour savoir comment utiliser cette méthode pour obtenir le numéro de page.

Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par GetPageNumber(ContentPosition).

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition, System::Object ^ userState);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition, object userState);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition, userState As Object)

Paramètres

Remarques

Cette surcharge de la méthode permet d’annuler cette opération asynchrone sans annuler toutes les opérations asynchrones.

Cette méthode déclenche l’événement GetPageNumberCompleted.

Les étapes suivantes illustrent comment récupérer le numéro de page d’une contentPosition donnée de manière asynchrone.

1. Créez un délégué GetPageNumberCompletedEventHandler et ajoutez-le pour être averti des événements GetPageNumberCompleted.

2. Appelez GetPageNumberAsync(ContentPosition, Object) en spécifiant le contentPosition souhaité et un objet userState unique qui sera utilisé pour identifier la tâche asynchrone.

3. Lorsque l’événement se produit et que le délégué est appelé, comparez la GetPageNumberCompletedEventArgsde l’événement.UserState propriété avec le paramètre de GetPageNumberAsyncuserState d’origine.

4. Lorsque le GetPageNumberCompletedEventArgs.UserState propriété correspond au GetPageNumberAsync(ContentPosition, Object)userStated’origine, l’opération est terminée et le numéro de page est prêt. (La propriété GetPageNumberCompletedEventArgs.ContentPosition correspond également au paramètre de GetPageNumberAsync(ContentPosition, Object)contentPosition d’origine.)

5. Le GetPageNumberCompletedEventArgs.PageNumber propriété contient le numéro de page de base zéro du contentPositionspécifié.

GetPageNumber fournit des fonctionnalités similaires à GetPageNumberAsync, mais pour une opération synchrone.