TableCollection

TableCollection class

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

public class TableCollection : NodeCollection

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

Имя Описание
Count { get; } Получает количество узлов в коллекции.
Item { get; } Получает Стол по данному индексу. (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;
}

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