Comment ajouter un tableau à un document DOCX

This article was translated from English: Does it need improvement?
Translated
View the article in English

Un tableau est une grille de cellules disposées en lignes et en colonnes. Il est utilisé pour organiser et présenter des informations dans un format structuré. Chaque intersection d'une ligne et d'une colonne est une cellule, qui peut contenir du texte, des nombres ou d'autres types de données. Les tableaux sont couramment utilisés pour organiser des données de manière ordonnée, créer des calendriers ou mettre en forme des informations de manière visuellement organisée.

Démarrer avec IronWord

Commencez à utiliser IronWord dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
green arrow pointer


Exemple d'ajout de tableau

Un tableau est un élément important d'un document Word. Tout d'abord, instanciez la classe Table en indiquant le nombre de lignes et de colonnes. À partir de là, il est possible de personnaliser le style du tableau, comme la couleur d'arrière-plan, l'ombrage, la bordure, les bandes zébrées et la largeur. Deuxièmement, il est possible d'accéder à chaque cellule du tableau de manière très intuitive en spécifiant la ligne et la colonne du tableau en [ligne, colonne] format. Dans chaque cellule, il est possible d'ajouter du texte, des images, des formes, des paragraphes ou même des tableaux entiers. Enfin, ce tableau peut être ajouté au document Word.

Conseils
Toutes les positions d'indexation des lignes et des colonnes suivent l'indexation basée sur le zéro.

: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 Text("Number"));
table[0, 1] = new TableCell(new Text("First Name"));
table[0, 2] = new TableCell(new Text("Last Name"));
for (int i = 1; i < table.Rows.Count; i++)
{
    table[i, 0].AddChild(new Text($"{i}"));
    table[i, 1].AddChild(new Text($"---"));
    table[i, 2].AddChild(new Text($"---"));
}

// 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 Text("Number"))
table(0, 1) = New TableCell(New Text("First Name"))
table(0, 2) = New TableCell(New Text("Last Name"))
For i As Integer = 1 To table.Rows.Count - 1
	table(i, 0).AddChild(New Text($"{i}"))
	table(i, 1).AddChild(New Text($"---"))
	table(i, 2).AddChild(New Text($"---"))
Next i

' Add table
doc.AddTable(table)

doc.Save("document.docx")
VB   C#
Ajouter une table

La méthode AddContent de la classe TableCell accepte un objet ContentElement, qui comprend tout, des paragraphes aux images, en passant par les formes et le tableau lui-même. Dans ce cas, vous pouvez avoir des tableaux imbriqués, ce qui constitue une illustration très utile pour certains cas d'utilisation.

Styles disponibles

Frontières

Explorez toutes les options disponibles pour les valeurs de bordure qui peuvent être définies à l'aide de l'enum BorderValues :

Valeurs limites