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

Observações

A única forma de cancelar a operação assíncrona deste método é cancelar todas as operações assíncronas. Compare isto com a outra sobrecarga deste método: GetPageNumberAsync(ContentPosition, Object).

Este método eleva o GetPageNumberCompleted evento. O número da página é passado ao evento como um dos argumentos do evento. Veja GetPageNumberAsync(ContentPosition, Object) como usar este método para obter o número da página.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

Esta sobrecarga do método permite cancelar esta operação assíncrona sem cancelar todas as operações assíncronas.

Este método eleva o GetPageNumberCompleted evento.

Os passos seguintes ilustram como recuperar o número de página de um dado contentPosition de forma assíncrona.

1. Crie um GetPageNumberCompletedEventHandler delegado e adicione-o para ser notificado dos GetPageNumberCompleted eventos.

2. Chamada GetPageNumberAsync(ContentPosition, Object) que especifica o contentPosition objeto desejado e um objeto único userState que será usado para identificar a tarefa assíncrona.

3. Quando o evento ocorre e o delegado é chamado, compara a propriedade . do GetPageNumberCompletedEventArgsevento com o parâmetro originalGetPageNumberAsyncuserState.UserState

4. Quando a GetPageNumberCompletedEventArgspropriedade .UserState coincide com a original GetPageNumberAsync(ContentPosition, Object)userState, a operação está completa e o número de página está pronto. (A GetPageNumberCompletedEventArgspropriedade .ContentPosition também corresponderá ao parâmetro original GetPageNumberAsync(ContentPosition, Object)contentPosition .)

5. A GetPageNumberCompletedEventArgspropriedade .PageNumber contém o número de página baseado em zero do especificado contentPosition.

GetPageNumber fornece funcionalidades semelhantes à GetPageNumberAsyncde , mas para operação síncrona.