DynamicDocumentPaginator.GetPageNumberAsync Метод

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)

Параметры

Комментарии

Единственным способом отмены асинхронной операции этого метода является отмена всех асинхронных операций. Контрастирует с другой перегрузкой этого метода: GetPageNumberAsync(ContentPosition, Object)

Этот метод вызывает GetPageNumberCompleted событие. Номер страницы передается событию в качестве одного из аргументов события. Узнайте GetPageNumberAsync(ContentPosition, Object) , как использовать этот метод для получения номера страницы.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых 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)

Параметры

Комментарии

Эта перегрузка метода позволяет отменить эту асинхронную операцию без отмены всех асинхронных операций.

Этот метод вызывает GetPageNumberCompleted событие.

Ниже показано, как получить номер страницы заданного contentPosition асинхронно.

1. GetPageNumberCompletedEventHandler Создайте делегат и добавьте его для уведомления о событияхGetPageNumberCompleted.

2. Вызов GetPageNumberAsync(ContentPosition, Object) , указывающий требуемый contentPosition и уникальный userState объект, который будет использоваться для идентификации асинхронной задачи.

3. При возникновении события и вызове делегата сравните свойство события GetPageNumberCompletedEventArgs.UserState с исходным GetPageNumberAsyncuserState параметром.

4. GetPageNumberCompletedEventArgsКогда свойство .UserState соответствует исходномуGetPageNumberAsync(ContentPosition, Object)userState, операция завершается и номер страницы готов. GetPageNumberCompletedEventArgs(Свойство .ContentPosition также будет соответствовать исходному GetPageNumberAsync(ContentPosition, Object)contentPosition параметру.)

5. Свойство GetPageNumberCompletedEventArgs.PageNumber содержит отсчитываемый от нуля номер страниц указанного contentPosition.

GetPageNumber предоставляет аналогичные функции, как GetPageNumberAsyncи для синхронной операции.