Bagikan melalui

DocumentPaginator.GetPageAsync Metode

  • Referensi

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 peristiwa GetPageCompleted) DocumentPage untuk nomor halaman yang ditentukan dan menetapkan ID yang ditentukan ke tugas asinkron.
GetPageAsync(Int32)

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

GetPageAsync(Int32, Object)

Secara asinkron mengembalikan (melalui peristiwa GetPageCompleted) 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 dari DocumentPage yang akan didapatkan.

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 peristiwa GetPageCompleted. DocumentPage diteruskan ke peristiwa sebagai salah satu argumen peristiwa.

Langkah-langkah berikut mengilustrasikan cara mengambil DocumentPage secara asinkron:

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

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

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

  4. Ketika GetPageCompletedEventArgs.UserState properti cocok dengan GetPageAsync(Int32, Object)userStateasli , operasi selesai dan halaman siap.

  5. Panggil GetPage untuk mengambil DocumentPageyang diformat .

Berlaku untuk

GetPageAsync(Int32)

Secara asinkron mengembalikan (melalui peristiwa GetPageCompleted) 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. Berbeda dengan kelebihan metode ini lainnya: GetPageAsync(Int32, Object).

Metode ini meningkatkan peristiwa GetPageCompleted. DocumentPage diteruskan 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).

Berlaku untuk