Lucrul cu seturi de pagini

Lucrul cu Seturi de Pagini

Acest ghid arată cum să descrii un subset de pagini ale unui document – o selecție arbitrară de indici de pagină, în loc de un interval unic contigu – utilizând PageSet in Aspose.Words FOSS pentru .NET. PageSet este o clasă sigilată în Aspose.Words.Saving spațiu de nume care descrie un set aleatoriu de pagini.

Construirea unui PageSet

PageSet are trei constructori: PageSet(page) creează un set de o pagină dintr-un singur indice de pagină; PageSet(pages) creează un set dintr-o colecție de indici de pagină exacti; și PageSet(ranges) creează un set dintr-o colecție de intervale de pagini. Alege constructorul care corespunde modului în care selecția de pagini este exprimată în scenariul tău — o pagină singură, o listă dispersată de pagini sau intervale continue.

Seturi Încorporate: Toate, Pare și Impare

Trei proprietăți statice furnizează seturi gata făcute fără a construi manual una: PageSet.All returnează un set cu fiecare pagină a documentului în ordinea originală, PageSet.Even returnează un set care conține doar paginile numerotate cu numere pare, iar PageSet.Odd returnează un set care conține doar paginile numerotate cu numere impare.

Enumerarea unui Set de Pagini

PageSet implementează IEnumerable<int>, astfel încât orice instanță PageSet – fie construită direct, fie obținută din All, Even sau Odd – poate fi iterată cu GetEnumerator() (sau cu o buclă foreach) pentru a parcurge indicii de pagină pe care îi conține.

Sfaturi și cele mai bune practici

Folosiți PageSet.All, Even sau Odd pentru cazurile comune în loc să construiți o listă explicită de indici, cu excepția situației în care selecția nu se potrivește cu niciunul dintre acele trei modele.
Alegeți constructorul PageSet(pages) pentru o selecție de pagini dispersată, necontiguă, și PageSet(ranges) atunci când selecția este exprimată natural ca una sau mai multe intervale contigue.
Deoarece PageSet implementează IEnumerable<int>, poate fi utilizat oriunde se așteaptă un IEnumerable<int> de indici de pagină, fără niciun pas suplimentar de conversie.

Probleme comune

Problemă	Cauză	Remediere
Un `PageSet` construit din `PageSet.Even` sau `Odd` apare gol când este enumerat pe un document scurt	Documentul are mai puține pagini pare (sau impare) decât era de așteptat	Confirmă numărul real de pagini al documentului înainte de a te baza pe `Even`/`Odd`
Nu ești sigur ce constructor să folosești pentru un amestec de pagini individuale și intervale	`PageSet(pages)` și `PageSet(ranges)` acceptă fiecare doar un singur tip de intrare	Creează instanțe separate de `PageSet` pentru indici și intervale, sau normalizează selecția la un singur tip înainte de a o construi

FAQ

Cum pot obține un PageSet care să conțină fiecare pagină a unui document?

Utilizaţi proprietatea statică PageSet.All.

Cum selectez doar paginile pare sau impare?

Utilizaţi PageSet.Even sau PageSet.Odd.

Cum construiesc un PageSet dintr-o listă arbitrară de numere de pagină?

Utilizaţi constructorul PageSet(pages) cu o colecție de indici de pagină exacti.

Pot itera peste paginile pe care le conţine un PageSet?

Da – PageSet implementează IEnumerable<int>, astfel încât GetEnumerator() sau o buclă foreach parcurge indicii de pagină pe care îi descrie.

API Reference Rezumat

Clasă	Descriere:
`PageSet`	Descrie un set de pagini; constructori pentru o pagină unică, indici exacti sau intervale; `All`, `Even`, `Odd`, `GetEnumerator()`

Vezi și:

Aspose.Words for .NET — Enterprise Documentation