DocumentPaginator.GetPageAsync Yöntem

Tanım

Ad Alanı:

System.Windows.Documents

Bütünleştirilmiş Kod:

PresentationCore.dll

Belirtilen sayfa numarasının değerini zaman uyumsuz olarak döndürür DocumentPage .

Aşırı Yüklemeler

Name	Description
GetPageAsync(Int32, Object)	Belirtilen sayfa numarası için zaman uyumsuz olarak öğesini döndürür (olay aracılığıyla GetPageCompleted ) DocumentPage ve belirtilen kimliği zaman uyumsuz göreve atar.
GetPageAsync(Int32)	Belirtilen sayfa numarası için zaman uyumsuz olarak öğesini döndürür (olay DocumentPage aracılığıylaGetPageCompleted).

GetPageAsync(Int32, Object)

Belirtilen sayfa numarası için zaman uyumsuz olarak öğesini döndürür (olay aracılığıyla GetPageCompleted ) DocumentPage ve belirtilen kimliği zaman uyumsuz göreve atar.

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)

Parametreler

pageNumber

Int32

Alınacak öğesinin DocumentPage sıfır tabanlı sayfa numarası.

userState

Object

Zaman uyumsuz görev için benzersiz tanımlayıcı.

Özel durumlar

ArgumentOutOfRangeException

pageNumber negatiftir.

Açıklamalar

Yönteminin bu aşırı yüklemesi, tüm zaman uyumsuz işlemleri iptal etmeden bu zaman uyumsuz işlemi iptal etme işlemini mümkün kılar.

Bu yöntem olayı tetikler GetPageCompleted . DocumentPage, olay bağımsız değişkenlerinden biri olarak olaya geçirilir.

Aşağıdaki adımlarda zaman uyumsuz olarak DocumentPage nasıl alınacak gösterilmektedir:

1. Bir GetPageCompletedEventHandler temsilci oluşturun ve olayları bildirecek GetPageCompleted şekilde ekleyin.

2. zaman uyumsuz olayın tamamlanmasını tanımlamak için kullanılacak istenen ve benzersiz userStatebir öğesini belirten pageNumber çağrısıGetPageAsync(Int32, Object).

3. Olay gerçekleştiğinde ve temsilci çağrıldığında, olayın GetPageCompletedEventArgs.UserState özelliğini özgün GetPageAsync(Int32, Object)userState parametresiyle karşılaştırın. GetPageCompletedEventArgs(.PageNumber özelliği de çağrıda belirtilenle GetPageAsync(Int32, Object) eşleşirpageNumber.)

4. GetPageCompletedEventArgs.UserState özelliği özgün GetPageAsync(Int32, Object)userStateile eşleştiğinde işlem tamamlanır ve sayfa hazırdır.

5. Biçimlendirilmiş DocumentPageöğesini almak için çağrısıGetPage.

GetPageAsync(Int32)

Belirtilen sayfa numarası için zaman uyumsuz olarak öğesini döndürür (olay DocumentPage aracılığıylaGetPageCompleted).

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)

Parametreler

pageNumber

Int32

Gerekli belge sayfasının sıfır tabanlı sayfa numarası.

Özel durumlar

ArgumentOutOfRangeException

pageNumber negatiftir.

Açıklamalar

Bu yöntemin zaman uyumsuz işlemini iptal etmenin tek yolu tüm zaman uyumsuz işlemleri iptal etmektir. Bu yöntemin diğer aşırı yüklemesiyle karşıtlık: GetPageAsync(Int32, Object).

Bu yöntem olayı tetikler GetPageCompleted . DocumentPage, olay bağımsız değişkenlerinden biri olarak olaya geçirilir. Sayfayı almak için bu yöntemin nasıl kullanılacağına bakın GetPageAsync(Int32, Object) .

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından GetPage(Int32)oluşan özel durumlara bakın.