TableCollection

TableCollection class

Bietet typisierten Zugriff auf eine Sammlung vonTable Knoten.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Tabellen Dokumentationsartikel.

public class TableCollection : NodeCollection

Eigenschaften

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

Methoden

Name	Beschreibung
Add(Node)	Fügt einen Knoten am Ende der Sammlung hinzu.
Clear()	Entfernt alle Knoten aus dieser Sammlung und aus dem Dokument.
Contains(Node)	Bestimmt, ob ein Knoten in der Sammlung ist.
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 Tabellenarray. (2 methods)

Beispiele

Zeigt, wie die ersten und letzten Zeilen 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 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>
/// Bestimmt, ob eine Tabelle in ihren Zellen eine unmittelbar untergeordnete Tabelle enthält.
/// Diese Tabellen nicht rekursiv durchlaufen, um nach weiteren Tabellen zu suchen.
/// </summary>
/// <returns>
/// Gibt true zurück, wenn mindestens eine untergeordnete Zelle eine Tabelle enthält.
/// Gibt false zurück, wenn keine Zellen in der Tabelle eine Tabelle enthalten.
/// </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

TableAlignment Enum TableStyleOptions Enum