Aracılığıyla paylaş

DocumentPaginator.GetPageAsync Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Documents
Bütünleştirilmiş Kod:
PresentationCore.dll

Belirtilen sayfa numarası için DocumentPage zaman uyumsuz olarak döndürür.

Aşırı Yüklemeler

GetPageAsync(Int32, Object)

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

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

GetPageAsync(Int32, Object)

Zaman uyumsuz olarak belirtilen sayfa numarası için DocumentPage (GetPageCompleted olayı aracılığıyla) döndürür 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 DocumentPage sıfır tabanlı sayfa numarası.

userState
Object

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

Özel durumlar

ArgumentOutOfRangeException

pageNumber negatif.

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 GetPageCompleted olayını oluşturur. DocumentPage, olay bağımsız değişkenlerinden biri olarak olaya geçirilir.

Aşağıdaki adımlarda, zaman uyumsuz olarak DocumentPage alma işlemi gösterilmektedir:

  1. bir GetPageCompletedEventHandler temsilcisi oluşturun ve GetPageCompleted olaylarının bildirilmesi için bunu ekleyin.

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

  3. Olay gerçekleştiğinde ve temsilci çağrıldığında, olayın GetPageCompletedEventArgskarşılaştırın. özgün GetPageAsync(Int32, Object)userState parametresiyleUserState özelliği. (GetPageCompletedEventArgs.PageNumber özelliği, GetPageAsync(Int32, Object) çağrısında belirtilen pageNumber de eşleşir.)

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

  5. Biçimlendirilmiş DocumentPagealmak için GetPage çağırın.

Şunlara uygulanır

GetPageAsync(Int32)

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

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 negatif.

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 GetPageCompleted olayını oluşturur. DocumentPage, olay bağımsız değişkenlerinden biri olarak olaya geçirilir. Sayfayı almak için bu yöntemin nasıl kullanılacağını öğrenmek için bkz. 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ı yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için, GetPage(Int32)tarafından oluşan özel durumlara bakın.

Şunlara uygulanır