DocumentPaginator.GetPageAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve de forma asincrónica el para DocumentPage el número de página especificado.
Sobrecargas
| Nombre | Description |
|---|---|
| GetPageAsync(Int32, Object) |
Devuelve de forma asincrónica (a través del GetPageCompleted evento) para DocumentPage el número de página especificado y asigna el identificador especificado a la tarea asincrónica. |
| GetPageAsync(Int32) |
Devuelve de forma asincrónica (a través del GetPageCompleted evento) el para DocumentPage el número de página especificado. |
GetPageAsync(Int32, Object)
Devuelve de forma asincrónica (a través del GetPageCompleted evento) para DocumentPage el número de página especificado y asigna el identificador especificado a la tarea asincrónica.
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)Parámetros
- pageNumber
- Int32
Número de página de base cero del objeto DocumentPage que se va a obtener.
- userState
- Object
Identificador único de la tarea asincrónica.
Excepciones
pageNumber es negativo.
Comentarios
Esta sobrecarga del método permite cancelar esta operación asincrónica sin cancelar todas las operaciones asincrónicas.
Este método genera el GetPageCompleted evento . DocumentPage se pasa al evento como uno de los argumentos del evento.
Los pasos siguientes muestran cómo recuperar un de DocumentPage forma asincrónica:
Cree un GetPageCompletedEventHandler delegado y agréguelo para recibir una notificación de GetPageCompleted eventos.
Llame a GetPageAsync(Int32, Object) especificando el
pageNumberdeseado y un únicouserState, que se usará para identificar la finalización del evento asincrónico.Cuando se produce el evento y se llama al delegado, compare la propiedad . del evento con el parámetro original
userStateGetPageAsync(Int32, Object).GetPageCompletedEventArgsUserState (La GetPageCompletedEventArgspropiedad .PageNumber también coincidirá con elpageNumberespecificado en la GetPageAsync(Int32, Object) llamada).Cuando la GetPageCompletedEventArgspropiedad .UserState coincide con el original GetPageAsync(Int32, Object)
userState, la operación se completa y la página está lista.Llame GetPage a para recuperar el formato DocumentPage.
Se aplica a
GetPageAsync(Int32)
Devuelve de forma asincrónica (a través del GetPageCompleted evento) el para DocumentPage el número de página especificado.
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)Parámetros
- pageNumber
- Int32
Número de página de base cero de la página del documento que se necesita.
Excepciones
pageNumber es negativo.
Comentarios
La única manera de cancelar la operación asincrónica de este método es cancelar todas las operaciones asincrónicas. Contraste esto con la otra sobrecarga de este método: GetPageAsync(Int32, Object).
Este método genera el GetPageCompleted evento . DocumentPage se pasa al evento como uno de los argumentos del evento. Vea GetPageAsync(Int32, Object) cómo usar este método para obtener la página.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por GetPage(Int32).
