Section

Section class

Представляет один раздел в документе.

Чтобы узнать больше, посетитеРабота с разделами статья документации.

public sealed class Section : CompositeNode

Конструкторы

ИмяОписание
Section(DocumentBase)Инициализирует новый экземпляр класса Раздел.

Характеристики

ИмяОписание
Body { get; }ВозвращаетBody дочерний узел раздела.
Count { get; }Получает количество непосредственных дочерних элементов этого узла.
CustomNodeId { get; set; }Указывает пользовательский идентификатор узла.
virtual Document { get; }Получает документ, которому принадлежит этот узел.
FirstChild { get; }Получает первого дочернего элемента узла.
HasChildNodes { get; }Возвращаетистинный если у этого узла есть дочерние узлы.
HeadersFooters { get; }Обеспечивает доступ к узлам верхнего и нижнего колонтитула раздела.
override IsComposite { get; }Возвращаетистинный поскольку этот узел может иметь дочерние узлы.
LastChild { get; }Получает последнего дочернего узла узла.
NextSibling { get; }Получает узел, следующий сразу за этим узлом.
override NodeType { get; }ВозвращаетSection .
PageSetup { get; }Возвращает объект, который представляет настройки страницы и свойства раздела.
ParentNode { get; }Получает непосредственного родителя этого узла.
PreviousSibling { get; }Получает узел, непосредственно предшествующий этому узлу.
ProtectedForForms { get; set; }True, если раздел защищен для форм. Если раздел защищен для форм, пользователи могут выбирать и изменять текст только в полях формы в Microsoft Word.
Range { get; }ВозвращаетRange объект, представляющий часть документа, содержащуюся в этом узле.

Методы

ИмяОписание
override Accept(DocumentVisitor)Принимает посетителя.
AppendChild(Node)Добавляет указанный узел в конец списка дочерних узлов для этого узла.
AppendContent(Section)Вставляет копию содержимого исходного раздела в конец этого раздела.
ClearContent()Очищает раздел.
ClearHeadersFooters()Очищает верхние и нижние колонтитулы этого раздела.
Clone()Создает дубликат этого раздела.
Clone(bool)Создает дубликат узла.
CreateNavigator()Создает навигатор, который можно использовать для перемещения и чтения узлов.
DeleteHeaderFooterShapes()Удаляет все фигуры (объекты рисования) из верхних и нижних колонтитулов этого раздела.
EnsureMinimum()Гарантирует, что в разделе естьBody с однимParagraph .
GetAncestor(NodeType)Получает первого предка указанногоNodeType .
GetAncestor(Type)Получает первого предка указанного типа объекта.
GetChild(NodeType, int, bool)Возвращает N-й дочерний узел, соответствующий указанному типу.
GetChildNodes(NodeType, bool)Возвращает живую коллекцию дочерних узлов, соответствующих указанному типу.
GetEnumerator()Обеспечивает поддержку для каждой итерации стиля над дочерними узлами этого узла.
override GetText()Получает текст этого узла и всех его дочерних элементов.
IndexOf(Node)Возвращает индекс указанного дочернего узла в массиве дочерних узлов.
InsertAfter(Node, Node)Вставляет указанный узел сразу после указанного ссылочного узла.
InsertBefore(Node, Node)Вставляет указанный узел непосредственно перед указанным ссылочным узлом.
NextPreOrder(Node)Получает следующий узел в соответствии с алгоритмом обхода дерева предварительного заказа.
PrependChild(Node)Добавляет указанный узел в начало списка дочерних узлов для этого узла.
PrependContent(Section)Вставляет копию содержимого исходного раздела в начало этого раздела.
PreviousPreOrder(Node)Получает предыдущий узел в соответствии с алгоритмом обхода дерева предварительного заказа.
Remove()Удаляет себя от родителя.
RemoveAllChildren()Удаляет все дочерние узлы текущего узла.
RemoveChild(Node)Удаляет указанный дочерний узел.
RemoveSmartTags()Удаляет всеSmartTagузлы-потомки текущего узла.
SelectNodes(string)Выбирает список узлов, соответствующих выражению XPath.
SelectSingleNode(string)Выбирает первыйNode которое соответствует выражению XPath.
ToString(SaveFormat)Экспортирует содержимое узла в строку указанного формата.
ToString(SaveOptions)Экспортирует содержимое узла в строку, используя указанные параметры сохранения.

Примечания

Section можно иметь одинBody и максимум одинHeaderFooter каждогоHeaderFooterType .Body иHeaderFooter nodes может быть внутри в любом порядкеSection.

Минимальный допустимый раздел должен иметьBody с однимParagraph.

Каждый раздел имеет свой собственный набор свойств, которые определяют размер страницы, ориентацию, поля и т. д.

Вы можете создать копию раздела, используяClone. Копию можно вставить в тот же или другой документ.

Чтобы добавить, вставить или удалить целый раздел, включая разрыв раздела и свойства раздела , используйте методы классаSections объект.

Чтобы скопировать и вставить только содержимое раздела, исключая раздел Break и свойства раздела, используйтеAppendContent иPrependContent методы.

Примеры

Показывает, как вручную создать документ Aspose.Words.

Document doc = new Document();

// Пустой документ содержит один раздел, одно тело и один абзац.
// Вызов метода «RemoveAllChildren», чтобы удалить все эти узлы,
// и в итоге получим узел документа без дочерних элементов.
doc.RemoveAllChildren();

// В этом документе теперь нет составных дочерних узлов, к которым мы можем добавлять контент.
// Если мы хотим его отредактировать, нам нужно будет заново заполнить его коллекцию узлов.
// Сначала создаем новый раздел, а затем добавляем его как дочерний к корневому узлу документа.
Section section = new Section(doc);
doc.AppendChild(section);

// Установите некоторые свойства настройки страницы для раздела.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// Разделу необходимо тело, которое будет содержать и отображать все его содержимое
// на странице между заголовком и подвалом раздела.
Body body = new Body(doc);
section.AppendChild(body);

// Создайте абзац, установите некоторые свойства форматирования, а затем добавьте его как дочерний элемент к телу.
Paragraph para = new Paragraph(doc);

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

body.AppendChild(para);

// Наконец, добавим некоторый контент для оформления документа. Создать пробег,
// устанавливаем его внешний вид и содержимое, а затем добавляем его в качестве дочернего элемента к абзацу.
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");

Смотрите также

SaveFormat Enum SectionCollection Class