DocumentPaginator.GetPageAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Secara asinkron mengembalikan DocumentPage untuk nomor halaman yang ditentukan.
Overload
| Nama | Deskripsi |
|---|---|
| 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 -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer, userState As Object)Parameter
- pageNumber
- Int32
Nomor halaman berbasis nol dari yang akan DocumentPage didapatkan.
- userState
- Object
Pengidentifikasi unik untuk tugas asinkron.
Pengecualian
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 mengilustrasikan cara mengambil secara DocumentPage asinkron:
Buat GetPageCompletedEventHandler delegasi dan tambahkan untuk diberi tahu tentang GetPageCompleted peristiwa.
Panggilan GetPageAsync(Int32, Object) yang menentukan
pageNumberyang diinginkan dan unikuserState, yang akan digunakan untuk mengidentifikasi penyelesaian peristiwa asinkron.Ketika peristiwa terjadi dan delegasi dipanggil, bandingkan properti . peristiwa dengan parameter asliGetPageAsync(Int32, Object)
userState.GetPageCompletedEventArgsUserState (Properti GetPageCompletedEventArgs.PageNumber juga akan cocok dengan yangpageNumberditentukan dalam GetPageAsync(Int32, Object) panggilan.)GetPageCompletedEventArgsKetika properti .UserState cocok dengan aslinyaGetPageAsync(Int32, Object)
userState, operasi selesai dan halaman siap.Panggil GetPage untuk mengambil yang diformat DocumentPage.
Berlaku untuk
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 -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer)Parameter
- pageNumber
- Int32
Nomor halaman berbasis nol dari halaman dokumen yang diperlukan.
Pengecualian
pageNumber negatif.
Keterangan
Satu-satunya cara untuk membatalkan operasi asinkron dari metode ini adalah dengan membatalkan semua operasi asinkron. Kontras ini dengan kelebihan metode ini lainnya: 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).
