DocumentPaginator.GetPageAsync Méthode

Définition

Espace de noms:

System.Windows.Documents

Assembly:

PresentationCore.dll

Retourne de façon asynchrone la DocumentPage pour le numéro de page spécifié.

Surcharges

GetPageAsync(Int32, Object)	Retourne de façon asynchrone (via l’événement GetPageCompleted) l'DocumentPage pour le numéro de page spécifié et affecte l’ID spécifié à la tâche asynchrone.
GetPageAsync(Int32)	Retourne de façon asynchrone (via l’événement GetPageCompleted) l'DocumentPage pour le numéro de page spécifié.

GetPageAsync(Int32, Object)

Retourne de façon asynchrone (via l’événement GetPageCompleted) l'DocumentPage pour le numéro de page spécifié et affecte l’ID spécifié à la tâche asynchrone.

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

pageNumber

Int32

Numéro de page de base zéro du DocumentPage à obtenir.

userState

Object

Identificateur unique de la tâche asynchrone.

Exceptions

ArgumentOutOfRangeException

pageNumber est négative.

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.

GetPageAsync(Int32)

Retourne de façon asynchrone (via l’événement GetPageCompleted) l'DocumentPage pour le numéro de page spécifié.

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

pageNumber

Int32

Numéro de page de base zéro de la page de document nécessaire.

Exceptions

ArgumentOutOfRangeException

pageNumber est négative.

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).