SectionCollection
SectionCollection class
Una colección deSection objetos en el documento.
Para obtener más información, visite elTrabajar con secciones Artículo de documentación.
public class SectionCollection : NodeCollection
Propiedades
| Nombre | Descripción |
|---|---|
| Count { get; } | Obtiene el número de nodos en la colección. |
| Item { get; } | Recupera una sección en el índice dado. (2 indexers) |
Métodos
| Nombre | Descripción |
|---|---|
| Add(Node) | Agrega un nodo al final de la colección. |
| Clear() | Elimina todos los nodos de esta colección y del documento. |
| Contains(Node) | Determina si un nodo está en la colección. |
| GetEnumerator() | Proporciona una iteración simple al estilo “foreach” sobre la colección de nodos. |
| IndexOf(Node) | Devuelve el índice basado en cero del nodo especificado. |
| Insert(int, Node) | Inserta un nodo en la colección en el índice especificado. |
| Remove(Node) | Elimina el nodo de la colección y del documento. |
| RemoveAt(int) | Elimina el nodo en el índice especificado de la colección y del documento. |
| ToArray() | Copia todas las secciones de la colección a una nueva matriz de secciones. (2 methods) |
Observaciones
Un documento de Microsoft Word puede contener varias secciones. Para crear una sección en un documento de Microsoft Word, seleccione el comando Insertar/Salto y seleccione un tipo de salto. El salto especifica si la sección comienza en una página nueva o en la misma.
La inserción y eliminación de secciones mediante programación permite personalizar documentos producidos durante la combinación de correspondencia. Si un documento necesita tener contenido diferente o partes de él según ciertos criterios, puede crear un documento “maestro” que contenga varias secciones y eliminar algunas de ellas antes o después de la combinación de correspondencia.
Ejemplos
Muestra cómo agregar y eliminar secciones en un documento.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Section 1");
builder.InsertBreak(BreakType.SectionBreakNewPage);
builder.Write("Section 2");
Assert.AreEqual("Section 1\x000cSection 2", doc.GetText().Trim());
//Eliminar la primera sección del documento.
doc.Sections.RemoveAt(0);
Assert.AreEqual("Section 2", doc.GetText().Trim());
// Añade una copia de lo que ahora es la primera sección al final del documento.
int lastSectionIdx = doc.Sections.Count - 1;
Section newSection = doc.Sections[lastSectionIdx].Clone();
doc.Sections.Add(newSection);
Assert.AreEqual("Section 2\x000cSection 2", doc.GetText().Trim());
Ver también
- class NodeCollection
- espacio de nombres Aspose.Words
- asamblea Aspose.Words
