DocumentPaginator.GetPageAsync Méthode

public:
 virtual void GetPageAsync(int pageNumber, System::Object ^ userState);

public virtual void GetPageAsync (int pageNumber, object userState);

abstract member GetPageAsync : int * obj -> unit
override this.GetPageAsync : int * obj -> unit

Public Overridable Sub GetPageAsync (pageNumber As Integer, userState As Object)

Paramètres

Exceptions

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 GetPageCompleted. La DocumentPage est passée à l’événement en tant qu’arguments d’événement.

Les étapes suivantes illustrent comment récupérer une DocumentPage de façon asynchrone :

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

2. Appelez GetPageAsync(Int32, Object) en spécifiant le pageNumber souhaité et un userStateunique, qui sera utilisé pour identifier l’achèvement de l’événement asynchrone.

3. Lorsque l’événement se produit et que le délégué est appelé, comparez la GetPageCompletedEventArgsde l’événement.UserState propriété avec le paramètre de GetPageAsync(Int32, Object)userState d’origine. (La propriété GetPageCompletedEventArgs.PageNumber correspond également à la pageNumber spécifiée dans l’appel GetPageAsync(Int32, Object).)

4. Lorsque le GetPageCompletedEventArgs.UserState propriété correspond au GetPageAsync(Int32, Object)userStated’origine, l’opération est terminée et la page est prête.

5. Appelez GetPage pour récupérer le DocumentPagemis en forme.

public:
 virtual void GetPageAsync(int pageNumber);

public virtual void GetPageAsync (int pageNumber);

abstract member GetPageAsync : int -> unit
override this.GetPageAsync : int -> unit

Public Overridable Sub GetPageAsync (pageNumber As Integer)

Paramètres

Exceptions

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 : GetPageAsync(Int32, Object).

Cette méthode déclenche l’événement GetPageCompleted. La DocumentPage est passée à l’événement en tant qu’arguments d’événement. Consultez GetPageAsync(Int32, Object) pour savoir comment utiliser cette méthode pour obtenir la 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 GetPage(Int32).