Создайте стол

Aspose.Words Это позволяет пользователям создавать таблицы в документе с нуля и предоставляет несколько различных методов для этого. В этой статье представлена подробная информация о том, как добавить отформатированные таблицы в ваш документ с использованием каждого метода, а также сравнение каждого метода в конце статьи.

По умолчанию Table Styles

Вновь созданной таблице приведены значения по умолчанию, аналогичные тем, которые используются в Microsoft Word:

Настольная собственность	Дефолт в Aspose.Words
Border Style	Single
Border Width	1/2 pt
Цвет границы	Black
Left and Right Padding	5.4 pts
AutoFit Mode	AutoFit to Window
Allow AutoFit	True
Таблица может быть встроенной, если она плотно расположена, или плавающей, если она может быть размещена в любом месте на странице. По умолчанию, Aspose.Words Всегда создает таблицы.

Создайте таблицу с документостроителем

В Aspose.Words, Пользователи могут создать таблицу в документе, используя DocumentBuilder. Основной алгоритм создания таблицы выглядит следующим образом:

1. Начните стол с StartTable
2. Добавьте ячейку к столу, используя InsertCell Это автоматически запускает новый ряд
3. По желанию, используйте CellFormat свойство определять форматирование ячеек
4. Вставьте содержимое ячейки с использованием соответствующего DocumentBuilder Такие методы, как Writeln, InsertImage, и другие
5. Повторять шаги 2-4 до завершения строки
6. Звони. EndRow Чтобы закончить текущий ряд
7. По желанию, используйте RowFormat свойство указывать форматирование строк
8. Повторите шаги 2-7, пока таблица не будет завершена
9. Звони. EndTable Чтобы закончить строительство стола

Важные детали:

• StartTable Его также можно назвать внутри клетки, и в этом случае он начинает создание вложенного стола внутри клетки.
• После звонка InsertCell, создается новая ячейка и любой контент, который вы добавляете, используя другие методы DocumentBuilder Класс будет добавлен к текущей ячейке. Чтобы создать новую ячейку в том же ряду, позвоните InsertCell Опять.
• Если InsertCell Называется сразу после EndRow В конце строки стол продолжится на новой строке.
• EndTable Способ окончания таблицы следует вызывать только один раз после вызова EndRow. Звонок EndTable перемещает курсор из текущей ячейки в положение сразу после стола.

Процесс создания таблицы можно четко увидеть на следующей картинке:

Следующий пример кода показывает, как создать простую таблицу DocumentBuilder с форматированием по умолчанию:

Следующий пример кода показывает, как создать отформатированную таблицу с помощью DocumentBuilder:

Следующий пример кода показывает, как вставить вложенную таблицу с помощью DocumentBuilder:

Создайте стол через DOM ()Document Object Model)

Вы можете вставлять таблицы непосредственно в DOM Добавляя новый Table Узел в определенной позиции.

Обратите внимание, что сразу после создания столового узла сам стол будет полностью пустым, то есть он еще не содержит строк и ячеек. Чтобы вставить строки и ячейки в таблицу, добавьте соответствующие Row и Cell Детские узлы в DOM.

Этот метод создания таблицы использует те же по умолчанию таблицы, что и при использовании таблицы. DocumentBuilder.

Следующий пример кода показывает, как построить новую таблицу с нуля, добавив соответствующие узлы ребенка в дерево документов:

Создайте таблицу из HTML

Aspose.Words поддерживает вставку контента в документ из источника HTML с использованием InsertHtml метод. Ввод может быть полной HTML-страницей или просто частичным фрагментом.

Используя это InsertHtml метод, пользователи могут вставлять таблицы в документ с помощью тегов таблицы, таких как <table>, <tr>, <td>.

Следующий пример кода показывает, как вставить таблицу в документ из строки, содержащей теги HTML:

Вставить копию существующего стола

Нередко возникает необходимость создания таблицы на основе уже существующей таблицы в документе. Самый простой способ дублировать таблицу, сохраняя при этом все форматирование, - это клонировать узел таблицы с помощью deepClone метод.

Этот же метод можно использовать для добавления копий существующей строки или ячейки в таблицу.

Следующий пример кода показывает, как дублировать таблицу с помощью конструкторов узлов:

Вы можете скачать образец файла этого примера из Aspose.Words GitHub.

Следующий пример кода показывает, как клонировать последнюю строку таблицы и добавить ее к таблице:

Вы можете скачать образец файла этого примера из Aspose.Words GitHub.

Если вы смотрите на создание таблиц в документе, которые динамически растут с каждой записью из вашего источника данных, то вышеупомянутый метод не рекомендуется. Вместо этого желаемый результат легче достигается с помощью Mail merge с регионами. Вы можете узнать больше об этой технике в Mail Merge с регионами Раздел.

Сравните способы создания таблицы

Aspose.Words Предоставляет несколько способов создания новых таблиц в документе. Каждый метод имеет свои преимущества и недостатки, поэтому выбор того, какой из них использовать, часто зависит от конкретной ситуации.

Давайте подробнее рассмотрим эти способы создания таблиц и сравним их плюсы и минусы:

метод	Преимущества	Недостатки
Виа DocumentBuilder	Стандартный метод вставки таблиц и другого содержания документов	Иногда трудно создать много разновидностей таблиц одновременно с одним и тем же экземпляром конструктора
Виа DOM	Лучше подходит с окружающим кодом, который создает и вставляет узлы непосредственно в DOM Без использования a DocumentBuilder	Таблица создается “пустой”: перед выполнением большинства операций необходимо позвонить EnsureMinimum Создание любых недостающих узлов ребенка
Из HTML	Можно создать новую таблицу из HTML-источника с помощью тегов <table>, <tr>, <td>	Не все возможно Microsoft Word Форматы таблиц могут быть применены к HTML
Клонирование существующего стола	Вы можете создать копию существующей таблицы, сохраняя при этом форматирование всех строк и ячеек	Соответствующие детские узлы должны быть удалены до того, как стол будет готов к использованию