Comment travailler avec les tables dans .NET

Étape 1: installer le package

Aspose.Words FOSS for .NET ne publie pas encore de package NuGet — compilez la bibliothèque à partir du code source à la place. Clonez https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, puis compilez Aspose.Words.sln en configuration Release avec le SDK .NET et référencez l’assembly Aspose.Words résultant dans votre projet. La bibliothèque cible .NET Standard 2.0, elle s’exécute donc sur .NET Framework 4.6.2+ et .NET 6/8/10.

Étape 2: importer les classes requises

Ajoutez une directive using Aspose.Words; pour les classes de document de base (Document, DocumentBuilder), ainsi qu’une directive using Aspose.Words.Tables; pour les classes spécifiques aux tables couvertes par ce guide — Table, Row, Cell, CellFormat, RowFormat, PreferredWidth, et les énumérations associées.

Étape 3 : Construisez une nouvelle table avec DocumentBuilder

Créez un Document et un DocumentBuilder qui y sont liés, puis appelez DocumentBuilder.StartTable() pour démarrer une table au curseur. Pour chaque cellule d’une ligne, appelez DocumentBuilder.InsertCell(), puis fermez la ligne avec DocumentBuilder.EndRow(). Répétez autant de fois que nécessaire pour les lignes de la table, et fermez la table entière avec DocumentBuilder.EndTable(). Chaque StartTable() nécessite un EndTable() correspondant, et chaque ligne nécessite un EndRow() correspondant, sinon l’état interne du constructeur — et l’arbre de document résultant — devient malformé.

Étape 4 : Formatez les cellules et les lignes pendant la construction

Définissez DocumentBuilder.CellFormat et DocumentBuilder.RowFormat avant d’appeler InsertCell() ou EndRow() afin d’appliquer le formatage aux cellules et aux lignes que le constructeur est sur le point de créer — ces deux propriétés servent de modèle pour le nouveau contenu, et non de modification rétroactive des cellules déjà insérées. CellFormat expose Borders, Shading, Width, WrapText, FitText, HorizontalMerge, VerticalMerge, VerticalAlignment, PreferredWidth et les quatre propriétés de remplissage (LeftPadding, RightPadding, TopPadding, BottomPadding), qui peuvent toutes être définies en une fois avec SetPaddings(). RowFormat expose Borders, Height, HeightRule, AllowBreakAcrossPages et HeadingFormat. Appelez CellFormat.ClearFormatting() ou RowFormat.ClearFormatting() pour réinitialiser l’un ou l’autre aux valeurs par défaut avant de définir de nouvelles valeurs pour la ligne ou la cellule suivante.

Étape 5 : Définissez la mise en page du tableau et AutoFit

Une fois le tableau créé, définissez les propriétés de mise en page directement sur l’objet Table : Alignment (TableAlignment), Bidi, LeftIndent, PreferredWidth, Style, StyleIdentifier, StyleName, StyleOptions (TableStyleOptions) et TextWrapping. Appelez Table.SetBorders() pour appliquer un style de bordure, une largeur et une couleur sur l’ensemble du tableau, ou Table.SetBorder() pour définir un seul côté; ClearBorders() et ClearShading() réinitialisent ces paramètres. Table.AutoFit(AutoFitBehavior) redimensionne le tableau et ses cellules selon le comportement choisi — appelez-le à nouveau après toute modification structurelle, car il reflète l’état du tableau uniquement au moment de son exécution, pas en continu.

Étape 6 : Définissez les largeurs préférées et celles des cellules

Créez des valeurs de largeur avec les méthodes de fabrique statiques PreferredWidth.FromPercent() pour une mise en page qui s’adapte à la largeur de page disponible, ou PreferredWidth.FromPoints() pour une largeur fixe; PreferredWidthType indique quel type de valeur (Auto, Percent ou Points) possède un PreferredWidth donné. Assignez le résultat à Table.PreferredWidth pour l’ensemble du tableau ou à CellFormat.PreferredWidth pour une cellule.

Étape 7 : Fusionner les cellules

Marquez les cellules comme fusionnées en définissant CellFormat.HorizontalMerge ou CellFormat.VerticalMerge (tous deux tapés CellMerge) sur les cellules qui doivent participer à la fusion. Si les cellules n’étaient fusionnées visuellement qu’en faisant correspondre leurs largeurs plutôt qu’en étant explicitement signalées, appelez Table.ConvertToHorizontallyMergedCells() pour convertir cet agencement visuel en cellules avec un véritable état CellMerge. CellVerticalAlignment contrôle la façon dont le contenu est justifié verticalement dans une cellule, indépendamment de toute fusion.

Étape 8 : Lire les tableaux d’un document existant

Pour travailler avec les tableaux déjà présents dans un document chargé, lisez Body.Tables (ou la propriété Tables sur tout autre Story) — un TableCollection — plutôt que de créer de nouveaux. Table.Rows renvoie un RowCollection et Row.Cells renvoie un CellCollection; les trois types de collections prennent en charge Add(), Insert(), Remove(), RemoveAt(), Contains() et IndexOf() pour les modifications programmatiques. Après avoir supprimé des lignes ou des cellules, appelez Table.EnsureMinimum(), Row.EnsureMinimum() ou Cell.EnsureMinimum() afin que le nœud conserve la structure minimale valide attendue par Word — une ligne vide, une cellule vide ou un paragraphe vide, respectivement.