Bekerja dengan Set Halaman

Panduan ini menunjukkan cara mendeskripsikan subset halaman dokumen – pilihan indeks halaman yang arbitrer, bukan satu rentang berurutan tunggal – menggunakan PageSet in Aspose.Words FOSS untuk .NET. PageSet adalah kelas sealed di dalam Aspose.Words.Saving namespace yang menggambarkan sekumpulan halaman secara acak.

Membangun PageSet

PageSet memiliki tiga konstruktor: PageSet(page) membuat set satu halaman dari satu indeks halaman; PageSet(pages) membuat set dari kumpulan indeks halaman yang tepat; dan PageSet(ranges) membuat set dari kumpulan rentang halaman. Pilih konstruktor yang sesuai dengan cara pemilihan halaman diungkapkan dalam skenario Anda – satu halaman, daftar halaman yang tersebar, atau rentang berurutan.

Set Bawaan: Semua, Genap, dan Ganjil

Tiga properti statis menyediakan set siap pakai tanpa harus membuatnya secara manual: PageSet.All mengembalikan set dengan setiap halaman dokumen dalam urutan aslinya, PageSet.Even mengembalikan set hanya dengan halaman bernomor genap, dan PageSet.Odd mengembalikan set hanya dengan halaman bernomor ganjil.

Mengeumerasi Set Halaman

PageSet mengimplementasikan IEnumerable<int>, jadi setiap instance PageSet – baik yang dibangun secara langsung atau diperoleh dari All, Even, atau Odd – dapat diiterasi dengan GetEnumerator() (atau loop foreach) untuk menelusuri indeks halaman yang dikandungnya.

Tips dan Praktik Terbaik

Gunakan PageSet.All, Even, atau Odd untuk kasus umum alih-alih membuat daftar indeks secara eksplisit, kecuali pemilihannya tidak cocok dengan salah satu dari tiga pola tersebut.
Pilih konstruktor PageSet(pages) untuk pemilihan halaman yang tersebar dan tidak berurutan, dan PageSet(ranges) ketika pemilihan dapat secara alami diungkapkan sebagai satu atau beberapa rentang berurutan.
Karena PageSet mengimplementasikan IEnumerable<int>, ia dapat digunakan di mana saja IEnumerable<int> indeks halaman diharapkan, tanpa langkah konversi tambahan.

Masalah Umum

Masalah	Penyebab	Perbaikan
Sebuah `PageSet` yang dibangun dari `PageSet.Even` atau `Odd` tampak kosong ketika dienumerasi pada dokumen pendek	Dokumen memiliki lebih sedikit halaman genap (atau ganjil) daripada yang diharapkan	Konfirmasi jumlah halaman sebenarnya dari dokumen sebelum mengandalkan `Even`/`Odd`
Tidak yakin konstruktor mana yang harus digunakan untuk campuran halaman individual dan rentang	`PageSet(pages)` dan `PageSet(ranges)` masing-masing hanya menerima satu bentuk input	Buat instance `PageSet` terpisah untuk indeks dan rentang, atau normalisasi pilihan menjadi satu bentuk sebelum membuatnya

FAQ

Bagaimana cara saya mendapatkan PageSet yang berisi setiap halaman dari sebuah dokumen?

Gunakan properti statis PageSet.All.

Bagaimana cara saya memilih hanya halaman genap atau ganjil?

Gunakan PageSet.Even atau PageSet.Odd.

Bagaimana cara membuat PageSet dari daftar nomor halaman yang arbitrer?

Gunakan konstruktor PageSet(pages) dengan koleksi indeks halaman yang tepat.

Apakah saya dapat mengiterasi halaman yang dimiliki oleh PageSet?

Ya – PageSet mengimplementasikan IEnumerable<int>, sehingga GetEnumerator() atau loop foreach melintasi indeks halaman yang dijelaskannya.

API Reference Ringkasan

Kelas	Deskripsi
`PageSet`	Mendeskripsikan sekumpulan halaman; konstruktor untuk satu halaman, indeks tepat, atau rentang; `All`, `Even`, `Odd`, `GetEnumerator()`

Lihat Juga

Aspose.Words for .NET — Enterprise Documentation