Trabajando con conjuntos de páginas
Trabajando con Conjuntos de Páginas
Esta guía muestra cómo describir un subconjunto de las páginas de un documento – una selección arbitraria de índices de página, en lugar de un único rango contiguo – usando PageSet in Aspose.Words FOSS para .NET. PageSet es una clase sellada en el Aspose.Words.Saving espacio de nombres que describe un conjunto aleatorio de páginas.
Construyendo un PageSet
PageSet tiene tres constructores: PageSet(page) crea un conjunto de una sola página a partir de un único índice de página; PageSet(pages) crea un conjunto a partir de una colección de índices de página exactos; y PageSet(ranges) crea un conjunto a partir de una colección de rangos de páginas. Elija el constructor que coincida con la forma en que la selección de páginas se expresa en su escenario – una sola página, una lista dispersa de páginas, o intervalos contiguos.
Conjuntos incorporados: Todos, Pares y Impares
Tres propiedades estáticas proporcionan conjuntos listos para usar sin construir uno manualmente: PageSet.All devuelve un conjunto con todas las páginas del documento en su orden original, PageSet.Even devuelve un conjunto con solo las páginas pares, y PageSet.Odd devuelve un conjunto con solo las páginas impares.
Enumerando un Conjunto de Páginas
PageSet implementa IEnumerable<int>, por lo que cualquier instancia de PageSet – ya sea construida directamente o obtenida de All, Even, o Odd – puede iterarse con GetEnumerator() (o un bucle foreach) para recorrer los índices de página que contiene.
Consejos y Buenas Prácticas
- Utilice
PageSet.All,EvenoOddpara los casos comunes en lugar de construir una lista de índices explícita, a menos que la selección no coincida con uno de esos tres patrones. - Elija el constructor
PageSet(pages)para una selección de páginas dispersa y no contigua, yPageSet(ranges)cuando la selección se exprese naturalmente como uno o más intervalos contiguos. - Debido a que
PageSetimplementaIEnumerable<int>, puede consumirse donde se espere unIEnumerable<int>de índices de página, sin ningún paso de conversión adicional.
Problemas Comunes
| Problema | Causa | Corrección |
|---|---|---|
Un PageSet creado a partir de PageSet.Even o Odd aparece vacío cuando se enumera en un documento corto | El documento tiene menos páginas pares (o impares) de lo esperado | Confirma el recuento real de páginas del documento antes de depender de Even/Odd |
| No estás seguro de qué constructor usar para una combinación de páginas individuales y rangos | PageSet(pages) y PageSet(ranges) aceptan cada uno solo una forma de entrada | Crea instancias separadas de PageSet para los índices y los rangos, o normaliza la selección a una única forma antes de construirla |
FAQ
¿Cómo obtengo un PageSet que contenga todas las páginas de un documento?
Utilice la propiedad estática PageSet.All.
¿Cómo selecciono solo páginas pares o impares?
Utilice PageSet.Even o PageSet.Odd.
¿Cómo construyo un PageSet a partir de una lista arbitraria de números de página?
Utilice el constructor PageSet(pages) con una colección de índices de página exactos.
¿Puedo iterar sobre las páginas que contiene un PageSet?
Sí – PageSet implementa IEnumerable<int>, por lo que GetEnumerator() o un bucle foreach recorren los índices de página que describe.
API Reference Resumen
| Clase | Descripción |
|---|---|
PageSet | Describe un conjunto de páginas; constructores para una sola página, índices exactos o rangos; All, Even, Odd, GetEnumerator() |
