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. Compare esto con la otra sobrecarga de este método: GetPageNumberAsync(ContentPosition, Object).

Este método genera el GetPageNumberCompleted evento . El número de página se pasa al evento como uno de los argumentos del evento. Vea GetPageNumberAsync(ContentPosition, Object) 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 que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea 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 GetPageNumberCompleted evento .

En los pasos siguientes se muestra cómo recuperar el número de página de un determinado contentPosition de forma asincrónica.

1. Cree un GetPageNumberCompletedEventHandler delegado y agréguelo para recibir notificaciones de GetPageNumberCompleted eventos.

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

3. Cuando se produce el evento y se llama al delegado, compare la propiedad . del evento con el parámetro originaluserStateGetPageNumberAsync.GetPageNumberCompletedEventArgsUserState

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

5. La GetPageNumberCompletedEventArgspropiedad .PageNumber contiene el número de página de base cero del especificado contentPosition.

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