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. Comparez cela 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 comme l’un des arguments de l’é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 de non-utilisation que le é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 manière 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 donnée contentPosition de manière asynchrone.

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

2. Appel GetPageNumberAsync(ContentPosition, Object) spécifiant le contentPosition souhaité et un objet unique userState 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 propriété . de GetPageNumberCompletedEventArgsl’événement avec le paramètre d’origineGetPageNumberAsyncuserState.UserState

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

5. La GetPageNumberCompletedEventArgspropriété .PageNumber contient le numéro de page de base zéro du spécifié contentPosition.

GetPageNumber fournit des fonctionnalités similaires à GetPageNumberAsync, mais pour les opérations synchrones.