TableCollection

TableCollection class

Bietet getippten Zugriff auf eine Sammlung vonTable Knoten.

public class TableCollection : NodeCollection

Eigenschaften

Name Beschreibung
Count { get; } Ruft die Anzahl der Knoten in der Sammlung ab.
Item { get; } Ruft a Tisch am angegebenen Index. (2 indexers)

Methoden

Name Beschreibung
Add(Node) Fügt am Ende der Sammlung einen Knoten hinzu.
Clear() Entfernt alle Knoten aus dieser Sammlung und aus dem Dokument.
Contains(Node) Bestimmt, ob sich ein Knoten in der Sammlung befindet.
GetEnumerator() Bietet eine einfache Iteration im “foreach”-Stil über die Sammlung von Knoten.
IndexOf(Node) Gibt den nullbasierten Index des angegebenen Knotens zurück.
Insert(int, Node) Fügt am angegebenen Index einen Knoten in die Sammlung ein.
Remove(Node) Entfernt den Knoten aus der Sammlung und aus dem Dokument.
RemoveAt(int) Entfernt den Knoten am angegebenen Index aus der Sammlung und aus dem Dokument.
ToArray() Kopiert alle Tabellen aus der Sammlung in ein neues Array von Tabellen. (2 methods)

Beispiele

Zeigt, wie die erste und letzte Zeile aller Tabellen in einem Dokument entfernt werden.

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);

Zeigt, wie man herausfindet, ob Tabellen verschachtelt sind.

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];

        // Finden Sie heraus, ob irgendwelche Zellen in der Tabelle andere Tabellen als Kinder haben.
        int count = GetChildTableCount(table);
        Console.WriteLine("Table #{0} has {1} tables directly within its cells", i, count);

        // Finden Sie heraus, ob die Tabelle in einer anderen Tabelle verschachtelt ist, und wenn ja, in welcher Tiefe.
        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>
/// Berechnet, auf welcher Ebene eine Tabelle in anderen Tabellen verschachtelt ist.
/// </summary>
/// <returns>
/// Eine Ganzzahl, die die Verschachtelungstiefe der Tabelle angibt (Anzahl der übergeordneten Tabellenknoten).
/// </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>
/// Ermittelt, ob eine Tabelle eine unmittelbar untergeordnete Tabelle in ihren Zellen enthält.
/// Diese Tabellen nicht rekursiv durchlaufen, um nach weiteren Tabellen zu suchen.
/// </summary>
/// <returns>
/// Gibt wahr zurück, wenn mindestens eine untergeordnete Zelle eine Tabelle enthält.
/// Gibt false zurück, wenn keine Zelle in der Tabelle eine Tabelle enthält.
/// </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;
}

Siehe auch