DocumentPaginator.GetPageAsync 메서드

정의

네임스페이스:

System.Windows.Documents

어셈블리:

PresentationCore.dll

지정된 페이지 번호의 DocumentPage 값을 비동기적으로 반환합니다.

오버로드

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

GetPageAsync(Int32, Object)

이벤트를 DocumentPage 통해 지정된 페이지 번호의 GetPageCompleted 값을 비동기적으로 반환하고 지정된 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. 비동기 이벤트의 완료를 pageNumber 식별하는 데 사용할 desired 및 uniqueuserState를 지정하는 호출 GetPageAsync(Int32, Object) 입니다.

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

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

5. 형식이 지정된 을 검색하기 위한 호출 GetPage 입니다 DocumentPage.

GetPageAsync(Int32)

이벤트를 통해 지정된 페이지 번호의 GetPageCompletedDocumentPage 값을 비동기적으로 반환합니다.

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같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 GetPage(Int32)throw된 예외를 참조하세요.