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

GetPageAsync(Int32, Object)	Belirtilen sayfa numarası için zaman uyumsuz olarak değerini 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 (olay aracılığıyla GetPageCompleted ) değerini DocumentPage döndürür.

GetPageAsync(Int32, Object)

Belirtilen sayfa numarası için zaman uyumsuz olarak değerini 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 olaylarla ilgili bildirim GetPageCompleted almak için ekleyin.

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

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ır durumdadır.

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

GetPageAsync(Int32)

Belirtilen sayfa numarası için zaman uyumsuz olarak (olay aracılığıyla GetPageCompleted ) değerini DocumentPage döndürür.

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. Bunu, bu yöntemin diğer aşırı yüklemesiyle karşıtlık oluşturun: 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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan GetPage(Int32)özel durumlara bakın.