DynamicDocumentPaginator.GetPageNumberAsync Metode

Definisi

Ruang nama:

System.Windows.Documents

Rakitan:

PresentationCore.dll

Mengembalikan nomor halaman berbasis nol dari ContentPositionyang ditentukan.

Overload

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

GetPageNumberAsync(ContentPosition)

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

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. Berbeda dengan kelebihan metode ini lainnya: GetPageNumberAsync(ContentPosition, Object).

Metode ini meningkatkan peristiwa GetPageNumberCompleted. 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 peristiwa GetPageNumberCompleted) nomor halaman berbasis nol dari ContentPositionyang ditentukan .

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 peristiwa GetPageNumberCompleted.

Langkah-langkah berikut mengilustrasikan cara mengambil nomor halaman dari contentPosition tertentu secara asinkron.

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

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

3. Ketika peristiwa terjadi dan delegasi dipanggil, bandingkan GetPageNumberCompletedEventArgsperistiwa .UserState properti dengan parameter GetPageNumberAsyncuserState asli.

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

5. GetPageNumberCompletedEventArgs.PageNumber properti berisi nomor halaman berbasis nol dari contentPositionyang ditentukan .

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