Bagikan melalui

DynamicDocumentPaginator.GetPageNumberAsync Metode

Definisi

Ruang nama:
System.Windows.Documents
Rakitan:
PresentationCore.dll

Mengembalikan nomor halaman berbasis nol dari yang ditentukan ContentPosition.

Overload

Nama Deskripsi
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. Kontras ini dengan kelebihan metode ini lainnya: 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).

Berlaku untuk

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 mengilustrasikan cara mengambil nomor halaman dari asinkron yang diberikan contentPosition .

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

  2. Panggilan GetPageNumberAsync(ContentPosition, Object) yang 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 aslinyaGetPageNumberAsync(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.

Berlaku untuk