DynamicDocumentPaginator.GetPageNumberAsync Método

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition)

Parámetros

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: GetPageNumberAsync(ContentPosition, Object).

Este método genera el evento GetPageNumberCompleted. El número de página se pasa al evento como uno de los argumentos del evento. Consulte GetPageNumberAsync(ContentPosition, Object) para ver cómo usar este método para obtener el número de 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 GetPageNumber(ContentPosition).

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition, System::Object ^ userState);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition, object userState);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition, userState As Object)

Parámetros

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 evento GetPageNumberCompleted.

Los pasos siguientes muestran cómo recuperar el número de página de un contentPosition determinado de forma asincrónica.

1. Cree un delegado GetPageNumberCompletedEventHandler y agréguelo para recibir una notificación de eventos GetPageNumberCompleted.

2. Llame a GetPageNumberAsync(ContentPosition, Object) especificar el contentPosition deseado y un objeto userState único que se usará para identificar la tarea asincrónica.

3. Cuando se produce el evento y se llama al delegado, compare el GetPageNumberCompletedEventArgsdel evento .UserState propiedad con el parámetro GetPageNumberAsyncuserState original.

4. Cuando el GetPageNumberCompletedEventArgs.UserState propiedad coincide con el GetPageNumberAsync(ContentPosition, Object)userStateoriginal , la operación está completa y el número de página está listo. (La propiedad GetPageNumberCompletedEventArgs.ContentPosition también coincidirá con el parámetro GetPageNumberAsync(ContentPosition, Object)contentPosition original).

5. El GetPageNumberCompletedEventArgs.PageNumber propiedad contiene el número de página de base cero del contentPositionespecificado.

GetPageNumber proporciona una funcionalidad similar a GetPageNumberAsync, pero para la operación sincrónica.