Comment ajouter un tableau à un document DOCX

Chaknith Bin
Chaknith Bin
janvier 9, 2024
Mise à jour décembre 25, 2024
Partager:
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, instancier la classe Table en fournissant 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, chaque cellule du tableau peut être accédée de manière très intuitive en spécifiant la ligne et la colonne du tableau au format [ligne, colonne]. 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 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")
$vbLabelText   $csharpLabel
Ajouter un tableau

La méthode AddChild de la classe TableCell accepte un objet ContentElement, qui inclut tout, des paragraphes, images et formes jusqu'à la table elle-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 :

Boundary values
Chaknith Bin
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il possède une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, une documentation améliorée et une expérience globale enrichie.