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 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
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 :
Créez un GetPageCompletedEventHandler délégué et ajoutez-le pour être averti des GetPageCompleted événements.
Appel GetPageAsync(Int32, Object) spécifiant le
pageNumber
souhaité 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 avec le paramètre d’origineGetPageAsync(Int32, Object)
userState
.UserState (La GetPageCompletedEventArgspropriété .PageNumber correspond également aupageNumber
spécifié 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.Appelez GetPage pour récupérer le format .DocumentPage
S’applique à
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
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).
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour