DocumentPaginator.GetPageAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne de façon asynchrone le DocumentPage numéro de page spécifié.
Surcharges
| Nom | Description |
|---|---|
| GetPageAsync(Int32, Object) |
Retourne de façon asynchrone (via l’événement GetPageCompleted ) le DocumentPage 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 ) le DocumentPage numéro de page spécifié. |
GetPageAsync(Int32, Object)
Retourne de façon asynchrone (via l’événement GetPageCompleted ) le DocumentPage 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 -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer, userState As Object)Paramètres
- pageNumber
- Int32
Numéro de page de base zéro de l’objet DocumentPage à obtenir.
- userState
- Object
Identificateur unique de la tâche asynchrone.
Exceptions
pageNumber est 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 . Il DocumentPage est passé à l’événement en tant qu’un des arguments d’événement.
Les étapes suivantes illustrent comment récupérer un élément DocumentPage de manière asynchrone :
Créez un GetPageCompletedEventHandler délégué et ajoutez-le pour être informé des GetPageCompleted événements.
Appel GetPageAsync(Int32, Object) spécifiant le
pageNumbersouhaité et un uniqueuserState, qui sera utilisé pour identifier l’achèvement de l’événement asynchrone.Lorsque l’événement se produit et que le délégué est appelé, comparez la propriété . de GetPageCompletedEventArgsl’événement au paramètre d’origineGetPageAsync(Int32, Object)
userState.UserState (La GetPageCompletedEventArgspropriété .PageNumber correspond également à cellepageNumberspécifiée dans l’appel GetPageAsync(Int32, Object) .)Lorsque la GetPageCompletedEventArgspropriété .UserState correspond à l’original GetPageAsync(Int32, Object)
userState, l’opération est terminée et la page est prête.Appel GetPage pour récupérer le formaté DocumentPage.
S’applique à
GetPageAsync(Int32)
Retourne de façon asynchrone (via l’événement GetPageCompleted ) le DocumentPage 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 -> unitPublic 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
pageNumber est négatif.
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 . Il DocumentPage est passé à l’événement en tant qu’un des arguments d’événement. Découvrez GetPageAsync(Int32, Object) 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).
