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, но для синхронной операции.