DynamicDocumentPaginator.GetPageNumberAsync Metode

Definisi

Ruang nama:

System.Windows.Documents

Rakitan:

PresentationCore.dll

Mengembalikan nomor halaman berbasis nol dari yang ditentukan ContentPosition.

Overload

GetPageNumberAsync(ContentPosition)	Secara asinkron, mengembalikan (melalui metode Ini meningkatkan GetPageNumberCompleted peristiwa) nomor halaman berbasis nol dari yang ditentukan ContentPosition.
GetPageNumberAsync(ContentPosition, Object)	Secara asinkron, mengembalikan (melalui metode Ini meningkatkan GetPageNumberCompleted peristiwa) nomor halaman berbasis nol dari yang ditentukan ContentPosition.

GetPageNumberAsync(ContentPosition)

Secara asinkron, mengembalikan (melalui metode Ini meningkatkan GetPageNumberCompleted peristiwa) nomor halaman berbasis nol dari yang ditentukan ContentPosition.

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition)

Parameter

contentPosition

ContentPosition

Posisi konten yang nomor halamannya diperlukan.

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: GetPageNumberAsync(ContentPosition, Object).

Metode ini meningkatkan GetPageNumberCompleted peristiwa. Nomor halaman diteruskan ke peristiwa sebagai salah satu argumen peristiwa. Lihat GetPageNumberAsync(ContentPosition, Object) cara menggunakan metode ini untuk mendapatkan nomor 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 GetPageNumber(ContentPosition).

GetPageNumberAsync(ContentPosition, Object)

Secara asinkron, mengembalikan (melalui metode Ini meningkatkan GetPageNumberCompleted peristiwa) nomor halaman berbasis nol dari yang ditentukan ContentPosition.

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition, System::Object ^ userState);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition, object userState);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition, userState As Object)

Parameter

contentPosition

ContentPosition

Elemen posisi konten untuk mengembalikan nomor halaman.

userState

Object

Pengidentifikasi unik untuk tugas asinkron.

Keterangan

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

Metode ini meningkatkan GetPageNumberCompleted peristiwa.

Langkah-langkah berikut menggambarkan cara mengambil nomor halaman dari yang diberikan contentPosition secara asinkron.

1. Buat GetPageNumberCompletedEventHandler delegasi dan tambahkan untuk diberi tahu tentang GetPageNumberCompleted peristiwa.

2. Panggilan GetPageNumberAsync(ContentPosition, Object) menentukan contentPosition objek yang diinginkan dan unik userState yang akan digunakan untuk mengidentifikasi tugas asinkron.

3. Ketika peristiwa terjadi dan delegasi dipanggil, bandingkan properti . peristiwa dengan parameter asliGetPageNumberAsyncuserState.GetPageNumberCompletedEventArgsUserState

4. GetPageNumberCompletedEventArgsKetika properti .UserState cocok dengan yang asliGetPageNumberAsync(ContentPosition, Object)userState, operasi selesai dan nomor halaman siap. (Properti GetPageNumberCompletedEventArgs.ContentPosition juga akan cocok dengan parameter asli GetPageNumberAsync(ContentPosition, Object)contentPosition .)

5. Properti GetPageNumberCompletedEventArgs.PageNumber berisi nomor halaman berbasis nol dari yang ditentukan contentPosition.

GetPageNumber menyediakan fungsionalitas serupa sebagai GetPageNumberAsync, tetapi untuk operasi sinkron.