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