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

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

Стили таблиц по умолчанию

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

Single
Black
True

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

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

В 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 (объектной модели документа)

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

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

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

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

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

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

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

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

Вставьте копию существующей таблицы

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

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

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

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

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

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

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

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

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