SectionCollection

SectionCollection class

Una colección de Sección objetos en el documento.

public class SectionCollection : NodeCollection

Propiedades

Nombre Descripción
Count { get; } Obtiene el número de nodos de 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 de estilo “foreach” simple sobre la colección de nodos.
IndexOf(Node) Devuelve el índice de base 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 Microsoft Word, seleccione el comando Insertar/Cortar y seleccione un tipo de ruptura. El salto especifica si la sección comienza en una página nueva o en la misma página.

La inserción y eliminación de secciones mediante programación se puede usar para personalizar los documentos producidos durante la combinación de correspondencia. Si un documento debe tener contenido diferente o partes del contenido según algunos criterios, puede crear un documento “maestro” que contenga varias secciones y eliminar algunas de las secciones 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());

// Agregue 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