DynamicDocumentPaginator.GetPageNumberAsync 메서드

정의

네임스페이스:

System.Windows.Documents

어셈블리:

PresentationCore.dll

지정한 ContentPosition0부터 시작하는 페이지 번호를 반환합니다.

오버로드

GetPageNumberAsync(ContentPosition)	비동기적으로 지정된 ContentPosition0부터 시작하는 페이지 번호를 반환합니다(이 메서드를 통해 GetPageNumberCompleted 이벤트 발생).
GetPageNumberAsync(ContentPosition, Object)	비동기적으로 지정된 ContentPosition0부터 시작하는 페이지 번호를 반환합니다(이 메서드를 통해 GetPageNumberCompleted 이벤트 발생).

GetPageNumberAsync(ContentPosition)

비동기적으로 지정된 ContentPosition0부터 시작하는 페이지 번호를 반환합니다(이 메서드를 통해 GetPageNumberCompleted 이벤트 발생).

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

GetPageNumberAsync(ContentPosition, Object)

비동기적으로 지정된 ContentPosition0부터 시작하는 페이지 번호를 반환합니다(이 메서드를 통해 GetPageNumberCompleted 이벤트 발생).

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. 원하는 contentPosition 비동기 작업을 식별하는 데 사용할 고유한 userState 개체를 지정하는 GetPageNumberAsync(ContentPosition, Object) 호출합니다.

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

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

5. GetPageNumberCompletedEventArgs.PageNumber 속성에는 지정된 contentPosition0부터 시작하는 페이지 번호가 포함됩니다.

GetPageNumber GetPageNumberAsync유사한 기능을 제공하지만 동기 작업에는 해당합니다.