DocumentPaginator.GetPageAsync 메서드

정의

네임스페이스:

System.Windows.Documents

어셈블리:

PresentationCore.dll

지정된 페이지 번호에 대한 DocumentPage를 비동기적으로 반환합니다.

오버로드

GetPageAsync(Int32, Object)	지정된 페이지 번호에 대한 GetPageCompleted를 DocumentPage 이벤트를 통해 비동기적으로 반환하고 지정된 ID를 비동기 작업에 할당합니다.
GetPageAsync(Int32)	지정된 페이지 번호에 대한 GetPageCompleted를 DocumentPage 이벤트를 통해 비동기적으로 반환합니다.

GetPageAsync(Int32, Object)

지정된 페이지 번호에 대한 GetPageCompleted를 DocumentPage 이벤트를 통해 비동기적으로 반환하고 지정된 ID를 비동기 작업에 할당합니다.

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 -> unit

Public Overridable Sub GetPageAsync (pageNumber As Integer, userState As Object)

매개 변수

pageNumber

Int32

가져올 DocumentPage의 페이지 번호(0부터 시작)입니다.

userState

Object

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

예외

ArgumentOutOfRangeException

pageNumber가 음수입니다.

설명

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

이 메서드는 GetPageCompleted 이벤트입니다. DocumentPage 이벤트 인수의 하나로 이벤트에 전달 됩니다.

다음 단계를 검색 하는 방법을 보여 줍니다는 DocumentPage 비동기적으로:

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

2. 호출 GetPageAsync(Int32, Object) 를 지정 하는 pageNumber desired 및 고유한 userState, 비동기 이벤트의 완료를 식별 하는 데 사용할 됩니다.

3. 이벤트가 발생하고 대리자를 호출할 때 이벤트의 GetPageCompletedEventArgs.UserState 속성을 원래 GetPageAsync(Int32, Object)userState 매개 변수와 비교합니다. (. 속성은 GetPageCompletedEventArgs호출에 GetPageAsync(Int32, Object) 지정된 와도 일치 pageNumber 합니다PageNumber.)

4. .UserState 속성이 GetPageCompletedEventArgs원래 GetPageAsync(Int32, Object)userState와 일치하면 작업이 완료되고 페이지가 준비됩니다.

5. 호출 GetPage 형식이 지정 된 검색할 DocumentPage합니다.

GetPageAsync(Int32)

지정된 페이지 번호에 대한 GetPageCompleted를 DocumentPage 이벤트를 통해 비동기적으로 반환합니다.

public:
 virtual void GetPageAsync(int pageNumber);

public virtual void GetPageAsync (int pageNumber);

abstract member GetPageAsync : int -> unit
override this.GetPageAsync : int -> unit

Public Overridable Sub GetPageAsync (pageNumber As Integer)

매개 변수

pageNumber

Int32

필요한 문서 페이지의 페이지 번호(0부터 시작)입니다.

예외

ArgumentOutOfRangeException

pageNumber가 음수입니다.

설명

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

이 메서드는 GetPageCompleted 이벤트입니다. DocumentPage 이벤트 인수의 하나로 이벤트에 전달 됩니다. 참조 GetPageAsync(Int32, Object) 이 메서드를 사용 하 여 페이지를 가져오는 방법에 대 한 합니다.

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