Hinzufügen einer Tabelle zu DOCX mit C#35; mit IronWord

Wie füge ich eine Tabelle zu meinem Word-Dokument hinzu?

Eine Tabelle ist ein wesentlicher Bestandteil von Word-Dokumenten. Zuerst instanziieren Sie die Table-Klasse, indem Sie die Anzahl der Zeilen und Spalten angeben. Konfigurieren Sie das Styling der Tabelle, einschließlich Hintergrundfarbe, Schattierung, Rahmen, Zebrastreifen und Breite. Zweitens: Zugriff auf jede Zelle durch intuitive [Zeile, Spalte]-Indizierung. Fügen Sie zu jeder Zelle Text, Bilder, Formen, Absätze oder sogar Tabellen hinzu. Fügen Sie schließlich die Tabelle in das Word-Dokument ein.

Tabellen in IronWord bieten eine flexible Grundlage für die Organisation von strukturierten Daten in Word-Dokumenten. Ob Rechnungen, Berichte oder Datenzusammenfassungen, die Klasse Table bietet umfassende Kontrolle über Inhalt und Darstellung. Das Null-basierte Indexierungssystem vereinfacht die programmatische Iteration der Zellen, während umfangreiche Styling-Optionen für ein professionelles Erscheinungsbild sorgen.

:path=/static-assets/word/content-code-examples/how-to/add-table-add-table.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

WordDocument doc = new WordDocument();

// Create table
Table table = new Table(5, 3);

// Configure border style
BorderStyle borderStyle = new BorderStyle();
borderStyle.BorderColor = Color.Black;
borderStyle.BorderValue = BorderValues.Thick;
borderStyle.BorderSize = 5;

// Configure table border
TableBorders tableBorders = new TableBorders()
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle,
};

// Apply styling
table.Zebra = new ZebraColor("FFFFFF", "dddddd");
table.Borders = tableBorders;

// Populate table
table[0, 0] = new TableCell(new TextContent("Number"));
table[0, 1] = new TableCell(new TextContent("First Name"));
table[0, 2] = new TableCell(new TextContent("Last Name"));
for (int i = 1; i < table.Rows.Count; i++)
{
    table[i, 0].AddChild(new TextContent($"{i}"));
    table[i, 1].AddChild(new TextContent($"---"));
    table[i, 2].AddChild(new TextContent($"---"));
}

// Add table
doc.AddTable(table);

doc.Save("document.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

Private doc As New WordDocument()

' Create table
Private table As New Table(5, 3)

' Configure border style
Private borderStyle As New BorderStyle()
borderStyle.BorderColor = Color.Black
borderStyle.BorderValue = BorderValues.Thick
borderStyle.BorderSize = 5

' Configure table border
Dim tableBorders As New TableBorders() With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}

' Apply styling
table.Zebra = New ZebraColor("FFFFFF", "dddddd")
table.Borders = tableBorders

' Populate table
table(0, 0) = New TableCell(New TextContent("Number"))
table(0, 1) = New TableCell(New TextContent("First Name"))
table(0, 2) = New TableCell(New TextContent("Last Name"))
For i As Integer = 1 To table.Rows.Count - 1
	table(i, 0).AddChild(New TextContent($"{i}"))
	table(i, 1).AddChild(New TextContent($"---"))
	table(i, 2).AddChild(New TextContent($"---"))
Next i

' Add table
doc.AddTable(table)

doc.Save("document.docx")

Die AddChild-Methode der TableCell-Klasse akzeptiert ein ContentElement-Objekt, das Absätze, Bilder, Formen und Tabellen enthält. Dies ermöglicht verschachtelte Tabellen für komplexe Anwendungsfälle.

Bei der Arbeit mit Tabellenzellen bietet IronWord mehrere Ansätze für das Inhaltsmanagement. Instanziieren Sie eine TableCell mit anfänglichem Inhalt mit dem Konstruktor, oder fügen Sie schrittweise Inhalte mit der Methode AddChild hinzu. Diese Flexibilität ermöglicht den Aufbau komplexer Zellstrukturen, die verschiedene Inhaltstypen kombinieren. So kann eine einzelne Zelle beispielsweise einen Kopfabsatz, gefolgt von einem Bild und einer verschachtelten Tabelle für detaillierte Spezifikationen enthalten.

Hier ist ein Beispiel, das fortgeschrittene Zellpopulationstechniken demonstriert:

// Example: Creating cells with mixed content
TableCell complexCell = new TableCell();

// Add a styled paragraph
Paragraph header = new Paragraph();
header.Add(new TextContent("Product Details").Bold().FontSize = 14);
complexCell.AddChild(header);

// Add multiple text elements
complexCell.AddChild(new TextContent("SKU: "));
complexCell.AddChild(new TextContent("PROD-001").Bold());
complexCell.AddChild(new TextContent("\nPrice: $49.99"));

// Cells can also contain lists, images, and more
// This demonstrates the versatility of table cells in IronWord

// Example: Creating cells with mixed content
TableCell complexCell = new TableCell();

// Add a styled paragraph
Paragraph header = new Paragraph();
header.Add(new TextContent("Product Details").Bold().FontSize = 14);
complexCell.AddChild(header);

// Add multiple text elements
complexCell.AddChild(new TextContent("SKU: "));
complexCell.AddChild(new TextContent("PROD-001").Bold());
complexCell.AddChild(new TextContent("\nPrice: $49.99"));

// Cells can also contain lists, images, and more
// This demonstrates the versatility of table cells in IronWord

IRON VB CONVERTER ERROR developers@ironsoftware.com

Welche Styling-Optionen kann ich auf Tabellen anwenden?

IronWord bietet umfangreiche Styling-Funktionen für Tabellen und ermöglicht so die Erstellung optisch ansprechender und professioneller Dokumente. Neben grundlegenden Rändern und Farben können Sie auch die Auffüllung und Ausrichtung von Zellen steuern und bedingte Formatierungen durch Zebrastreifen anwenden. Das Styling-System kombiniert Leistung mit intuitivem Design, indem es vertraute Eigenschaftsnamen und klare Werteaufzählungen verwendet.

Welche Rahmenstile sind verfügbar?

Erforschen Sie alle verfügbaren Optionen für Randwerte mit dem BorderValues enum:

Die Aufzählung BorderValues bietet umfassende Optionen für die Tabellenästhetik. Jeder Stil, von einfachen einzelnen Linien bis hin zu komplexen Mustern wie Wellen und Punkten, dient bestimmten Designzwecken. Geschäftsdokumente profitieren von professionellen doppelten oder dreifachen Umrandungen, während kreative Dokumente Wellen- oder DashDot-Muster verwenden. Die Eigenschaft BorderSize arbeitet mit BorderValue zusammen, um eine präzise Steuerung der Liniendicke, gemessen in Achtelpunkten, zu ermöglichen.

Hier ist ein praktisches Beispiel, das verschiedene Rahmenkonfigurationen zeigt:

// Example: Applying different borders to table sections
Table styledTable = new Table(4, 4);

// Create distinct border styles for header and body
BorderStyle headerBorder = new BorderStyle
{
    BorderColor = Color.Navy,
    BorderValue = BorderValues.Double,
    BorderSize = 8
};

BorderStyle bodyBorder = new BorderStyle
{
    BorderColor = Color.Gray,
    BorderValue = BorderValues.Dotted,
    BorderSize = 3
};

// Apply different borders to different parts of the table
// This creates visual hierarchy and improves readability
styledTable.Borders = new TableBorders
{
    TopBorder = headerBorder,
    BottomBorder = headerBorder,
    LeftBorder = bodyBorder,
    RightBorder = bodyBorder,
    InsideHorizontalBorder = bodyBorder,
    InsideVerticalBorder = bodyBorder
};

// Zebra striping for better row distinction
styledTable.Zebra = new ZebraColor("F5F5F5", "FFFFFF");

// Example: Applying different borders to table sections
Table styledTable = new Table(4, 4);

// Create distinct border styles for header and body
BorderStyle headerBorder = new BorderStyle
{
    BorderColor = Color.Navy,
    BorderValue = BorderValues.Double,
    BorderSize = 8
};

BorderStyle bodyBorder = new BorderStyle
{
    BorderColor = Color.Gray,
    BorderValue = BorderValues.Dotted,
    BorderSize = 3
};

// Apply different borders to different parts of the table
// This creates visual hierarchy and improves readability
styledTable.Borders = new TableBorders
{
    TopBorder = headerBorder,
    BottomBorder = headerBorder,
    LeftBorder = bodyBorder,
    RightBorder = bodyBorder,
    InsideHorizontalBorder = bodyBorder,
    InsideVerticalBorder = bodyBorder
};

// Zebra striping for better row distinction
styledTable.Zebra = new ZebraColor("F5F5F5", "FFFFFF");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

Tabellenbreite und Alignment-Eigenschaften bieten zusätzliche Layout-Kontrolle. Setzen Sie Tabellen auf bestimmte Breiten oder Prozentsätze, richten Sie sie innerhalb des Dokuments aus und steuern Sie die Interaktion mit dem umgebenden Inhalt. Zu den Styling-Optionen auf Zellebene gehören individuelle Hintergrundfarben, Textausrichtung und Auffüllungsanpassungen, die eine granulare Kontrolle über jeden Aspekt des Tabellenaussehens ermöglichen.

Diese Styling-Optionen ermöglichen die Erstellung von Tabellen, die den Designanforderungen eines jeden Dokuments entsprechen, von einfachen Datenrastern bis hin zu komplexen Finanzberichten mit mehreren visuellen Hierarchien.