Section

Section class

Representa una sola sección en un documento.

public sealed class Section : CompositeNode

Constructores

Nombre Descripción
Section(DocumentBase) Inicializa una nueva instancia de la clase Sección.

Propiedades

Nombre Descripción
Body { get; } Devuelve el Cuerpo nodo hijo de la sección.
ChildNodes { get; } Obtiene todos los nodos secundarios inmediatos de este nodo.
Count { get; } Obtiene el número de hijos inmediatos de este nodo.
CustomNodeId { get; set; } Especifica el identificador de nodo personalizado.
virtual Document { get; } Obtiene el documento al que pertenece este nodo.
FirstChild { get; } Obtiene el primer hijo del nodo.
HasChildNodes { get; } Devuelve verdadero si este nodo tiene nodos secundarios.
HeadersFooters { get; } Proporciona acceso a los nodos de encabezados y pies de página de la sección.
override IsComposite { get; } Devuelve verdadero ya que este nodo puede tener nodos secundarios.
LastChild { get; } Obtiene el último hijo del nodo.
NextSibling { get; } Obtiene el nodo que sigue inmediatamente a este nodo.
override NodeType { get; } Devoluciones NodeType.Sección .
PageSetup { get; } Devuelve un objeto que representa la configuración de la página y las propiedades de la sección.
ParentNode { get; } Obtiene el padre inmediato de este nodo.
PreviousSibling { get; } Obtiene el nodo inmediatamente anterior a este nodo.
ProtectedForForms { get; set; } Verdadero si la sección está protegida para formularios. Cuando una sección está protegida para formularios, los usuarios pueden seleccionar y modificar texto solo en campos de formulario en Microsoft Word.
Range { get; } Devuelve un Rango objeto que representa la parte de un documento que está contenido en este nodo.

Métodos

Nombre Descripción
override Accept(DocumentVisitor) Acepta un visitante.
AppendChild(Node) Agrega el nodo especificado al final de la lista de nodos secundarios para este nodo.
AppendContent(Section) Inserta una copia del contenido de la sección fuente al final de esta sección.
ClearContent() Borra la sección.
ClearHeadersFooters() Borra los encabezados y pies de página de esta sección.
Clone() Crea un duplicado de esta sección.
Clone(bool) Crea un duplicado del nodo.
CreateNavigator() Reservado para uso del sistema. IXPathNavigable.
DeleteHeaderFooterShapes() Elimina todas las formas (objetos de dibujo) de los encabezados y pies de página de esta sección.
EnsureMinimum() Asegura que la sección tenga Cuerpo con un Párrafo.
GetAncestor(NodeType) Obtiene el primer ancestro del especificadoNodeType .
GetAncestor(Type) Obtiene el primer ancestro del tipo de objeto especificado.
GetChild(NodeType, int, bool) Devuelve un enésimo nodo secundario que coincide con el tipo especificado.
GetChildNodes(NodeType, bool) Devuelve una colección activa de nodos secundarios que coinciden con el tipo especificado.
GetEnumerator() Proporciona soporte para la iteración de cada estilo sobre los nodos secundarios de este nodo.
override GetText() Obtiene el texto de este nodo y de todos sus hijos.
IndexOf(Node) Devuelve el índice del nodo secundario especificado en la matriz de nodos secundarios.
InsertAfter(Node, Node) Inserta el nodo especificado inmediatamente después del nodo de referencia especificado.
InsertBefore(Node, Node) Inserta el nodo especificado inmediatamente antes del nodo de referencia especificado.
NextPreOrder(Node) Obtiene el siguiente nodo de acuerdo con el algoritmo de recorrido del árbol de pedido previo.
PrependChild(Node) Agrega el nodo especificado al principio de la lista de nodos secundarios para este nodo.
PrependContent(Section) Inserta una copia del contenido de la sección fuente al principio de esta sección.
PreviousPreOrder(Node) Obtiene el nodo anterior de acuerdo con el algoritmo de recorrido del árbol de pedido previo.
Remove() Se elimina a sí mismo del padre.
RemoveAllChildren() Elimina todos los nodos secundarios del nodo actual.
RemoveChild(Node) Elimina el nodo secundario especificado.
RemoveSmartTags() Elimina todoSmartTag nodos descendientes del nodo actual.
SelectNodes(string) Selecciona una lista de nodos que coinciden con la expresión XPath.
SelectSingleNode(string) Selecciona el primer nodo que coincide con la expresión XPath.
ToString(SaveFormat) Exporta el contenido del nodo a una cadena en el formato especificado.
ToString(SaveOptions) Exporta el contenido del nodo a una cadena utilizando las opciones de guardado especificadas.

Observaciones

Sección puede tener unoBody y maximo unoHeaderFooter de cadaHeaderFooterType . Cuerpo y EncabezadoPie de página nodes puede estar en cualquier orden dentro Sección.

Una sección válida mínima debe tener Cuerpo con uno Párrafo.

Cada sección tiene su propio conjunto de propiedades que especifican el tamaño de la página, la orientación, los márgenes, etc.

Puede crear una copia de una sección usandoClone. La copia se puede insertar en el mismo documento o uno diferente.

Para agregar, insertar o eliminar una sección completa, incluidos los saltos de sección y las propiedades de la sección , utilice los métodos de la Secciones objeto.

Para copiar e insertar solo el contenido de la sección, excluyendo la sección break y las propiedades de la sección, use Agregar contenido y AnteponerContenidométodos.

Ejemplos

Muestra cómo construir un documento de Aspose.Words a mano.

Document doc = new Document();

// Un documento en blanco contiene una sección, un cuerpo y un párrafo.
// Llame al método "RemoveAllChildren" para eliminar todos esos nodos,
// y terminar con un nodo de documento sin hijos.
doc.RemoveAllChildren();

// Este documento ahora no tiene nodos secundarios compuestos a los que podamos agregar contenido.
// Si deseamos editarlo, necesitaremos volver a llenar su colección de nodos.
// Primero, cree una nueva sección y luego agréguela como elemento secundario al nodo del documento raíz.
Section section = new Section(doc);
doc.AppendChild(section);

// Establecer algunas propiedades de configuración de página para la sección.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// Una sección necesita un cuerpo, que contendrá y mostrará todo su contenido
// en la página entre el encabezado y el pie de página de la sección.
Body body = new Body(doc);
section.AppendChild(body);

// Cree un párrafo, establezca algunas propiedades de formato y luego agréguelo como elemento secundario al cuerpo.
Paragraph para = new Paragraph(doc);

para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;

body.AppendChild(para);

// Finalmente, agregue algo de contenido para hacer el documento. Crear una carrera,
// establece su apariencia y contenido, y luego lo agrega como elemento secundario al párrafo.
Run run = new Run(doc);
run.Text = "Hello World!";
run.Font.Color = Color.Red;
para.AppendChild(run);

Assert.AreEqual("Hello World!", doc.GetText().Trim());

doc.Save(ArtifactsDir + "Section.CreateManually.docx");

Ver también