DocumentPaginator.GetPageAsync Metode

Definisi

Ruang nama:

System.Windows.Documents

Rakitan:

PresentationCore.dll

Secara asinkron mengembalikan DocumentPage untuk nomor halaman yang ditentukan.

Overload

GetPageAsync(Int32, Object)	Secara asinkron mengembalikan (melalui GetPageCompleted peristiwa) DocumentPage untuk nomor halaman yang ditentukan dan menetapkan ID yang ditentukan ke tugas asinkron.
GetPageAsync(Int32)	Secara asinkron mengembalikan (melalui GetPageCompleted peristiwa) DocumentPage untuk nomor halaman yang ditentukan.

GetPageAsync(Int32, Object)

Secara asinkron mengembalikan (melalui GetPageCompleted peristiwa) DocumentPage untuk nomor halaman yang ditentukan dan menetapkan ID yang ditentukan ke tugas asinkron.

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)

Parameter

pageNumber

Int32

Nomor halaman berbasis nol yang akan didapatkan DocumentPage .

userState

Object

Pengidentifikasi unik untuk tugas asinkron.

Pengecualian

ArgumentOutOfRangeException

pageNumber negatif.

Keterangan

Kelebihan metode ini memungkinkan untuk membatalkan operasi asinkron ini tanpa membatalkan semua operasi asinkron.

Metode ini meningkatkan GetPageCompleted peristiwa. diteruskan DocumentPage ke peristiwa sebagai salah satu argumen peristiwa.

Langkah-langkah berikut menggambarkan cara mengambil DocumentPage secara asinkron:

1. Buat GetPageCompletedEventHandler delegasi dan tambahkan untuk diberi tahu tentang GetPageCompleted peristiwa.

2. Panggilan GetPageAsync(Int32, Object) yang menentukan yang pageNumber diinginkan dan unik userState, yang akan digunakan untuk mengidentifikasi penyelesaian peristiwa asinkron.

3. Ketika peristiwa terjadi dan delegasi dipanggil, bandingkan properti . peristiwa dengan parameter asliGetPageAsync(Int32, Object)userState.GetPageCompletedEventArgsUserState (Properti GetPageCompletedEventArgs.PageNumber juga akan cocok dengan pageNumber yang ditentukan dalam GetPageAsync(Int32, Object) panggilan.)

4. GetPageCompletedEventArgsKetika properti .UserState cocok dengan yang asliGetPageAsync(Int32, Object)userState, operasi selesai dan halaman siap.

5. Panggil GetPage untuk mengambil yang diformat DocumentPage.

GetPageAsync(Int32)

Secara asinkron mengembalikan (melalui GetPageCompleted peristiwa) DocumentPage untuk nomor halaman yang ditentukan.

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)

Parameter

pageNumber

Int32

Nomor halaman berbasis nol dari halaman dokumen yang diperlukan.

Pengecualian

ArgumentOutOfRangeException

pageNumber negatif.

Keterangan

Satu-satunya cara untuk membatalkan operasi asinkron dari metode ini adalah dengan membatalkan semua operasi asinkron. Kontraskan ini dengan kelebihan beban lain dari metode ini: GetPageAsync(Int32, Object).

Metode ini meningkatkan GetPageCompleted peristiwa. diteruskan DocumentPage ke peristiwa sebagai salah satu argumen peristiwa. Lihat GetPageAsync(Int32, Object) cara menggunakan metode ini untuk mendapatkan halaman.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh GetPage(Int32).