DynamicDocumentPaginator.GetPageNumberAsync 方法

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)

參數

備註

取消此方法異步操作的唯一方法是取消所有異步操作。 與此方法的另一種過載形成對比： GetPageNumberAsync(ContentPosition, Object)。

此方法提升事件。GetPageNumberCompleted 頁碼會以其中一個事件自變數的形式傳遞至事件。 請參考 GetPageNumberAsync(ContentPosition, Object) 如何使用此方法取得頁碼。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 GetPageNumber(ContentPosition)拋出的例外。

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)

參數

備註

此方法的這個多載可讓您取消此異步操作，而不取消所有異步操作。

此方法提升事件。GetPageNumberCompleted

以下步驟說明如何非同步取得給定 contentPosition 的頁碼。

1. 建立一個 GetPageNumberCompletedEventHandler 代表並加入，這樣就能收到活動通知 GetPageNumberCompleted 。

2. 呼叫 GetPageNumberAsync(ContentPosition, Object) 指定 contentPosition 所需目標及 userState 唯一物件，用以識別非同步任務。

3. 當事件發生且代理被呼叫時，將事件的 GetPageNumberCompletedEventArgs.UserState property 與原始 GetPageNumberAsyncuserState 參數進行比較。

4. 當 .GetPageNumberCompletedEventArgs屬性與原始UserStateGetPageNumberAsync(ContentPosition, Object)屬性相符時userState，操作完成且頁碼已準備好。 （ GetPageNumberCompletedEventArgs.ContentPosition 屬性也會與原始 GetPageNumberAsync(ContentPosition, Object)contentPosition 參數相符。）

5. .GetPageNumberCompletedEventArgs屬性PageNumber包含指定 contentPosition的零基頁碼。

GetPageNumber 提供類似 GetPageNumberAsync的功能，但用於同步操作。