DocumentPaginator.GetPageAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно возвращает DocumentPage номер указанной страницы.
Перегрузки
| Имя | Описание |
|---|---|
| GetPageAsync(Int32, Object) |
Асинхронно возвращает (через GetPageCompleted событие) DocumentPage указанный номер страницы и назначает указанный идентификатор асинхронной задаче. |
| GetPageAsync(Int32) |
Асинхронно возвращает (через событие) DocumentPage указанный GetPageCompleted номер страницы. |
GetPageAsync(Int32, Object)
Асинхронно возвращает (через GetPageCompleted событие) DocumentPage указанный номер страницы и назначает указанный идентификатор асинхронной задаче.
public:
virtual void GetPageAsync(int pageNumber, System::Object ^ userState);public virtual void GetPageAsync(int pageNumber, object userState);abstract member GetPageAsync : int * obj -> unit
override this.GetPageAsync : int * obj -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer, userState As Object)Параметры
- pageNumber
- Int32
Отсчитываемый от нуля номер страницы DocumentPage для получения.
- userState
- Object
Уникальный идентификатор асинхронной задачи.
Исключения
pageNumber является отрицательным.
Комментарии
Эта перегрузка метода позволяет отменить эту асинхронную операцию без отмены всех асинхронных операций.
Этот метод вызывает GetPageCompleted событие. Передается DocumentPage в событие в качестве одного из аргументов события.
Ниже показано, как асинхронно получить следующее DocumentPage :
GetPageCompletedEventHandler Создайте делегат и добавьте его для уведомления о событияхGetPageCompleted.
Вызов GetPageAsync(Int32, Object) , указывающий требуемое
pageNumberи уникальноеuserState, которое будет использоваться для идентификации завершения асинхронного события.При возникновении события и вызове делегата сравните свойство события GetPageCompletedEventArgs.UserState с исходным GetPageAsync(Int32, Object)
userStateпараметром. GetPageCompletedEventArgs(Свойство .PageNumber также будет соответствоватьpageNumberуказанному в вызовеGetPageAsync(Int32, Object).)GetPageCompletedEventArgsКогда свойство .UserState соответствует исходномуGetPageAsync(Int32, Object)
userState, операция завершена и страница готова.Вызов GetPage для получения отформатированного DocumentPage.
Применяется к
GetPageAsync(Int32)
Асинхронно возвращает (через событие) DocumentPage указанный GetPageCompleted номер страницы.
public:
virtual void GetPageAsync(int pageNumber);public virtual void GetPageAsync(int pageNumber);abstract member GetPageAsync : int -> unit
override this.GetPageAsync : int -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer)Параметры
- pageNumber
- Int32
Отсчитываемый от нуля номер страницы документа.
Исключения
pageNumber является отрицательным.
Комментарии
Единственным способом отмены асинхронной операции этого метода является отмена всех асинхронных операций. Контрастирует с другой перегрузкой этого метода: GetPageAsync(Int32, Object)
Этот метод вызывает GetPageCompleted событие. Передается DocumentPage в событие в качестве одного из аргументов события. Узнайте GetPageAsync(Int32, Object) , как использовать этот метод для получения страницы.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых GetPage(Int32).
