DocumentPaginator.GetPageAsync 메서드

정의

네임스페이스:

System.Windows.Documents

어셈블리:

PresentationCore.dll

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

오버로드

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

GetPageAsync(Int32, Object)

지정된 페이지 번호에 대한 DocumentPageGetPageCompleted 이벤트를 통해 비동기적으로 반환하고 지정된 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 지정하고 비동기 이벤트의 완료를 식별하는 데 사용되는 고유한 userState지정하는 GetPageAsync(Int32, Object) 호출합니다.

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

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

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

GetPageAsync(Int32)

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

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됩니다. 저장된 예외는 GetPage(Int32)throw된 예외를 참조하세요.