DocumentPaginator.GetPageAsync Méthode

Définition

Espace de noms:

System.Windows.Documents

Assembly:

PresentationCore.dll

Retourne, de manière asynchrone, la DocumentPage correspondant au numéro de page spécifié.

Surcharges

GetPageAsync(Int32, Object)	Retourne, de manière asynchrone (par l'événement GetPageCompleted), la DocumentPage correspondant au numéro de page spécifié et assigne l'ID indiqué à la tâche asynchrone.
GetPageAsync(Int32)	Retourne, de manière asynchrone (par l'événement GetPageCompleted), la DocumentPage correspondant au numéro de page spécifié.

GetPageAsync(Int32, Object)

Retourne, de manière asynchrone (par l'événement GetPageCompleted), la DocumentPage correspondant au numéro de page spécifié et assigne l'ID indiqué à 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 de la DocumentPage à obtenir.

userState

Object

Identificateur unique de la tâche asynchrone.

Exceptions

ArgumentOutOfRangeException

pageNumber est un nombre négatif.

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 . est DocumentPage passé à l’événement comme l’un des arguments de l’événement.

Les étapes suivantes illustrent comment récupérer un de DocumentPage manière asynchrone :

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

2. Appel GetPageAsync(Int32, Object) spécifiant le pageNumber souhaité et un unique userState, 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 propriété . de GetPageCompletedEventArgsl’événement avec le paramètre d’origineGetPageAsync(Int32, Object)userState.UserState (La GetPageCompletedEventArgspropriété .PageNumber correspond également au pageNumber spécifié dans l’appel GetPageAsync(Int32, Object) .)

4. Lorsque la GetPageCompletedEventArgspropriété .UserState correspond à l’original GetPageAsync(Int32, Object)userState, l’opération est terminée et la page est prête.

5. Appelez GetPage pour récupérer le format .DocumentPage

GetPageAsync(Int32)

Retourne, de manière asynchrone (par l'événement GetPageCompleted), la DocumentPage correspondant au 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 requise.

Exceptions

ArgumentOutOfRangeException

pageNumber est un nombre négatif.

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

Cette méthode déclenche l’événement GetPageCompleted . est DocumentPage passé à l’événement comme l’un des arguments de l’é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 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 GetPage(Int32).