TableCollection

TableCollection class

Обеспечивает типизированный доступ к коллекцииTable узлы.

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

public class TableCollection : NodeCollection

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

ИмяОписание
Count { get; }Получает количество узлов в коллекции.
Item { get; }ПолучаетTable по данному индексу. (2 indexers)

Методы

ИмяОписание
Add(Node)Добавляет узел в конец коллекции.
Clear()Удаляет все узлы из этой коллекции и из документа.
Contains(Node)Определяет, находится ли узел в коллекции.
GetEnumerator()Обеспечивает простую итерацию стиля foreach по коллекции узлов.
IndexOf(Node)Возвращает индекс указанного узла, начинающийся с нуля.
Insert(int, Node)Вставляет узел в коллекцию по указанному индексу.
Remove(Node)Удаляет узел из коллекции и из документа.
RemoveAt(int)Удаляет узел по указанному индексу из коллекции и из документа.
ToArray()Копирует все таблицы из коллекции в новый массив таблиц. (2 methods)

Примеры

Показывает, как удалить первую и последнюю строки всех таблиц в документе.

Document doc = new Document(MyDir + "Tables.docx");

TableCollection tables = doc.FirstSection.Body.Tables;

Assert.AreEqual(5, tables[0].Rows.Count);
Assert.AreEqual(4, tables[1].Rows.Count);

foreach (Table table in tables.OfType<Table>())
{
    table.FirstRow?.Remove();
    table.LastRow?.Remove();
}

Assert.AreEqual(3, tables[0].Rows.Count);
Assert.AreEqual(2, tables[1].Rows.Count);

Показывает, как узнать, являются ли таблицы вложенными.

public void CalculateDepthOfNestedTables()
{
    Document doc = new Document(MyDir + "Nested tables.docx");
    NodeCollection tables = doc.GetChildNodes(NodeType.Table, true);
    for (int i = 0; i < tables.Count; i++)
    {
        Table table = (Table)tables[i];

        // Выясняем, есть ли в каких-либо ячейках таблицы дочерние другие таблицы.
        int count = GetChildTableCount(table);
        Console.WriteLine("Table #{0} has {1} tables directly within its cells", i, count);

        // Выясняем, вложена ли таблица в другую таблицу, и если да, то на какой глубине.
        int tableDepth = GetNestedDepthOfTable(table);

        if (tableDepth > 0)
            Console.WriteLine("Table #{0} is nested inside another table at depth of {1}", i,
                tableDepth);
        else
            Console.WriteLine("Table #{0} is a non nested table (is not a child of another table)", i);
    }
}

/// <summary>
/// Вычисляет уровень вложенности таблицы в другие таблицы.
/// </summary>
/// <returns>
/// Целое число, указывающее глубину вложенности таблицы (количество узлов родительской таблицы).
/// </returns>
private static int GetNestedDepthOfTable(Table table)
{
    int depth = 0;
    Node parent = table.GetAncestor(table.NodeType);

    while (parent != null)
    {
        depth++;
        parent = parent.GetAncestor(typeof(Table));
    }

    return depth;
}

/// <summary>
/// Определяет, содержит ли таблица в своих ячейках какую-либо непосредственную дочернюю таблицу.
/// Не просматривайте эти таблицы рекурсивно, чтобы проверить наличие дополнительных таблиц.
/// </summary>
/// <returns>
/// Возвращает true, если хотя бы одна дочерняя ячейка содержит таблицу.
/// Возвращает false, если ни одна из ячеек таблицы не содержит таблицу.
/// </returns>
private static int GetChildTableCount(Table table)
{
    int childTableCount = 0;

    foreach (Row row in table.Rows.OfType<Row>())
    {
        foreach (Cell Cell in row.Cells.OfType<Cell>())
        {
            TableCollection childTables = Cell.Tables;

            if (childTables.Count > 0)
                childTableCount++;
        }
    }

    return childTableCount;
}

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

TableAlignment Enum TableStyleOptions Enum