Section

Section class

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

public sealed class Section : CompositeNode

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

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

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

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

Методы

Имя Описание
override Accept(DocumentVisitor) Принимает посетителя.
AppendChild(Node) Добавляет указанный узел в конец списка дочерних узлов для этого узла.
AppendContent(Section) Вставляет копию содержимого исходного раздела в конец этого раздела.
ClearContent() Очищает раздел.
ClearHeadersFooters() Очищает верхние и нижние колонтитулы этого раздела.
Clone() Создает дубликат этого раздела.
Clone(bool) Создает дубликат узла.
CreateNavigator() Зарезервировано для системного использования. IXPathNavigable.
DeleteHeaderFooterShapes() Удаляет все фигуры (объекты рисования) из верхних и нижних колонтитулов этого раздела.
EnsureMinimum() Гарантирует, что раздел имеет тело с одним абзацем.
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) Выбирает первый узел, соответствующий выражению XPath.
ToString(SaveFormat) Экспортирует содержимое узла в строку в указанном формате.
ToString(SaveOptions) Экспортирует содержимое узла в строку, используя указанные параметры сохранения.

Примечания

Раздел может иметь одинBody и максимум одинHeaderFooter каждогоHeaderFooterType . Тело а также Верхний колонтитул nodes может быть в любом порядке внутри Раздел.

Минимальный действительный раздел должен иметь Тело с одним Параграф.

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

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

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

Чтобы скопировать и вставить только содержимое раздела, исключая раздел 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");

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