Construire une table avec style

Dans ce didacticiel, nous vous guiderons pas à pas à travers le processus de création d’un tableau stylisé à l’aide d’Aspose.Words pour .NET. Nous expliquerons le code source C# fourni et vous fournirons un guide complet pour vous aider à comprendre et à implémenter cette fonctionnalité dans vos propres projets. A la fin de ce tutoriel, vous saurez comment créer un tableau avec un style personnalisé dans vos documents Word à l’aide d’Aspose.Words pour .NET.

Étape 1 : Définir le répertoire des documents

Tout d’abord, vous devez définir le chemin d’accès à votre répertoire de documents. C’est l’emplacement où vous souhaitez enregistrer votre document Word modifié. Remplacez « VOTRE RÉPERTOIRE DE DOCUMENTS » par le chemin approprié.

string dataDir = "YOUR DOCUMENTS DIRECTORY";

Étape 2 : Créer un nouveau document et un générateur de documents

Ensuite, vous devez créer une nouvelle instance duDocument classe et un constructeur de document pour ce document.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Étape 3 : Démarrez un nouveau tableau et insérez une cellule

Pour commencer à construire la table, nous utilisons leStartTable() méthode du générateur de documents, puis nous insérons une cellule dans le tableau à l’aide de laInsertCell() méthode.

Table table = builder. StartTable();
builder. InsertCell();

Étape 4 : Définir le style du tableau

Nous pouvons maintenant définir le style du tableau en utilisant leStyleIdentifier propriété. Dans cet exemple, nous utilisons le style “MediumShading1Accent1”.

table.StyleIdentifier = StyleIdentifier.MediumShading1Accent1;

Étape 5 : Appliquer les options de style au tableau

Nous pouvons spécifier quelles caractéristiques doivent être formatées par le style en utilisant leStyleOptionspropriété du tableau. Dans cet exemple, nous appliquons les options suivantes : “FirstColumn”, “RowBands” et “FirstRow”.

table.StyleOptions = TableStyleOptions.FirstColumn | TableStyleOptions.RowBands | TableStyleOptions.FirstRow;

Étape 6 : Ajuster automatiquement la taille du tableau

Pour ajuster automatiquement la taille du tableau en fonction de son contenu, nous utilisons leAutoFit() méthode avec leAutoFitBehavior.AutoFitToContents comportement.

table. AutoFit(AutoFitBehavior.AutoFitToContents);

Étape 7 : ajouter du contenu aux cellules

Nous pouvons maintenant ajouter du contenu aux cellules en utilisant leWriteln() etInsertCell() méthodes du générateur de documents. Dans cet exemple, nous ajoutons les en-têtes pour “Article” et “Quantité (

kg)” et les données correspondantes.

builder.Writeln("Item");
builder.CellFormat.RightPadding = 40;
builder. InsertCell();
builder. Writen("Quantity (kg)");
builder. EndRow();
builder. InsertCell();
builder.Writeln("Apples");
builder. InsertCell();
builder.Writeln("20");
builder. EndRow();
builder. InsertCell();
builder.Writeln("Bananas");
builder. InsertCell();
builder. Writen("40");
builder. EndRow();
builder. InsertCell();
builder.Writeln("Carrots");
builder. InsertCell();
builder.Writeln("50");
builder. EndRow();

Étape 8 : Enregistrez le document modifié

Enfin, nous enregistrons le document modifié dans un fichier. Vous pouvez choisir un nom et un emplacement appropriés pour le document de sortie.

doc.Save(dataDir + "WorkingWithTableStylesAndFormatting.BuildTableWithStyle.docx");

Félicitation ! Vous avez maintenant créé un tableau de style personnalisé à l’aide d’Aspose.Words pour .NET.

Exemple de code source pour créer une table avec style à l’aide d’Aspose.Words pour .NET

	// Chemin d'accès à votre répertoire de documents
	string dataDir = "YOUR DOCUMENT DIRECTORY";

	Document doc = new Document();
	DocumentBuilder builder = new DocumentBuilder(doc);
	Table table = builder.StartTable();
	// Nous devons d'abord insérer au moins une ligne avant de définir un formatage de tableau.
	builder.InsertCell();
	// Définissez le style de tableau utilisé en fonction de l'identifiant de style unique.
	table.StyleIdentifier = StyleIdentifier.MediumShading1Accent1;
	// Appliquez les fonctionnalités qui doivent être formatées par le style.
	table.StyleOptions =
		TableStyleOptions.FirstColumn | TableStyleOptions.RowBands | TableStyleOptions.FirstRow;
	table.AutoFit(AutoFitBehavior.AutoFitToContents);
	builder.Writeln("Item");
	builder.CellFormat.RightPadding = 40;
	builder.InsertCell();
	builder.Writeln("Quantity (kg)");
	builder.EndRow();
	builder.InsertCell();
	builder.Writeln("Apples");
	builder.InsertCell();
	builder.Writeln("20");
	builder.EndRow();
	builder.InsertCell();
	builder.Writeln("Bananas");
	builder.InsertCell();
	builder.Writeln("40");
	builder.EndRow();
	builder.InsertCell();
	builder.Writeln("Carrots");
	builder.InsertCell();
	builder.Writeln("50");
	builder.EndRow();
	doc.Save(dataDir + "WorkingWithTableStylesAndFormatting.BuildTableWithStyle.docx");

Conclusion

Dans ce didacticiel, nous avons appris à créer un tableau stylisé à l’aide d’Aspose.Words pour .NET. En suivant ce guide étape par étape, vous pouvez facilement personnaliser le style de vos tableaux dans vos documents Word. Aspose.Words propose une API puissante et flexible pour manipuler et formater les tableaux de vos documents. Grâce à ces connaissances, vous pourrez améliorer la présentation visuelle de vos documents Word et répondre à des besoins spécifiques.