Section

Section class

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

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

public sealed class Section : CompositeNode

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

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

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

ИмяОписание
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)Принимает посетителя.
override AcceptEnd(DocumentVisitor)
override AcceptStart(DocumentVisitor)
AppendChild<T>(T)Добавляет указанный узел в конец списка дочерних узлов для данного узла.
AppendContent(Section)Вставляет копию содержимого исходного раздела в конец данного раздела.
ClearContent()Очищает раздел.
ClearHeadersFooters()Очищает верхние и нижние колонтитулы этого раздела.
ClearHeadersFooters(bool)Очищает верхние и нижние колонтитулы этого раздела.
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<T>(T, Node)Вставляет указанный узел сразу после указанного ссылочного узла.
InsertBefore<T>(T, Node)Вставляет указанный узел непосредственно перед указанным ссылочным узлом.
NextPreOrder(Node)Получает следующий узел в соответствии с алгоритмом обхода дерева предварительного порядка.
PrependChild<T>(T)Добавляет указанный узел в начало списка дочерних узлов для данного узла.
PrependContent(Section)Вставляет копию содержимого исходного раздела в начало этого раздела.
PreviousPreOrder(Node)Получает предыдущий узел в соответствии с алгоритмом обхода дерева предварительного порядка.
Remove()Удаляет себя из родителя.
RemoveAllChildren()Удаляет все дочерние узлы текущего узла.
RemoveChild<T>(T)Удаляет указанный дочерний узел.
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