DynamicDocumentPaginator.GetPageNumberAsync 메서드

정의

지정된 ContentPosition의 페이지 번호(0부터 시작)를 반환합니다.

오버로드

GetPageNumberAsync(ContentPosition)

이 메서드에서는 GetPageNumberCompleted 이벤트를 발생시켜 지정된 ContentPosition의 페이지 번호(0부터 시작)를 비동기적으로 반환합니다.

GetPageNumberAsync(ContentPosition, Object)

이 메서드에서는 GetPageNumberCompleted 이벤트를 발생시켜 지정된 ContentPosition의 페이지 번호(0부터 시작)를 비동기적으로 반환합니다.

GetPageNumberAsync(ContentPosition)

이 메서드에서는 GetPageNumberCompleted 이벤트를 발생시켜 지정된 ContentPosition의 페이지 번호(0부터 시작)를 비동기적으로 반환합니다.

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)

매개 변수

contentPosition
ContentPosition

페이지 번호가 필요한 콘텐츠 위치입니다.

설명

이 메서드의 비동기 작업을 취소 하는 유일한 방법은 모든 비동기 작업을 취소 하는 것입니다. 이 메서드의 다른 오버 로드를 사용 하 여이 대조해 보세요: GetPageNumberAsync(ContentPosition, Object)합니다.

이 메서드는 GetPageNumberCompleted 이벤트입니다. 페이지 번호를 이벤트 인수 중 하나로 이벤트에 전달 됩니다. 참조 GetPageNumberAsync(ContentPosition, Object) 페이지 번호를 가져오려면이 메서드를 사용 하는 방법에 대 한 합니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw GetPageNumber(ContentPosition)된 예외를 참조하세요.

적용 대상

GetPageNumberAsync(ContentPosition, Object)

이 메서드에서는 GetPageNumberCompleted 이벤트를 발생시켜 지정된 ContentPosition의 페이지 번호(0부터 시작)를 비동기적으로 반환합니다.

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)

매개 변수

contentPosition
ContentPosition

페이지 번호를 반환할 콘텐츠 위치 요소입니다.

userState
Object

비동기 작업의 고유 식별자입니다.

설명

메서드의이 오버 로드를 모든 비동기 작업을 취소 하지 않고이 비동기 작업을 취소할 수 있습니다.

이 메서드는 GetPageNumberCompleted 이벤트입니다.

다음 단계를의 페이지 번호를 검색 하는 방법을 보여 줍니다는 주어진 contentPosition 비동기적으로 합니다.

  1. 만들기는 GetPageNumberCompletedEventHandler 위임 하 고 알림을 받을 추가 GetPageNumberCompleted 이벤트입니다.

  2. 호출 GetPageNumberAsync(ContentPosition, Object) 를 지정 하는 contentPosition desired 및 고유한 userState 비동기 작업을 식별 하는 데 사용할 개체입니다.

  3. 이벤트가 발생하고 대리자를 호출할 때 이벤트의 GetPageNumberCompletedEventArgs.UserState 속성을 원래 GetPageNumberAsyncuserState 매개 변수와 비교합니다.

  4. .UserState 속성이 GetPageNumberCompletedEventArgs원래 GetPageNumberAsync(ContentPosition, Object)userState와 일치하면 작업이 완료되고 페이지 번호가 준비됩니다. (.ContentPosition 속성은 GetPageNumberCompletedEventArgs원래 GetPageNumberAsync(ContentPosition, Object)contentPosition 매개 변수와도 일치합니다.)

  5. . 속성에는 GetPageNumberCompletedEventArgs지정된 의 페이지 번호(0부터 시작)가 포함됩니다contentPosition.PageNumber

GetPageNumber 유사한 기능을 제공 GetPageNumberAsync에 있지만 동기 작업에 대 한 합니다.

적용 대상