Comment aligner le texte dans Word en utilisant C#

Comment aligner du texte dans un document Microsoft Word à l'aide d'IronWord NuGet

1. Créez un nouveau projet dans Microsoft Visual Studio.
2. Installez IronWord via le gestionnaire de packages NuGet.
3. Générez un document Word avec alignement du texte.
4. Explorez la propriété d'alignement du texte dans IronWord.

Qu'est-ce qu'IronWord ?

IronWord est une bibliothèque NuGet C# d' Iron Software développée pour faciliter la création, la manipulation et la gestion par programmation des fichiers Microsoft Word. Il permet aux développeurs d'automatiser le processus de génération de documents Word avec du texte aligné, facilitant ainsi la génération dynamique de rapports, de factures, de lettres et d'autres types de documents au sein de leurs applications.

Prérequis

Petit rappel pour vérifier que vous avez bien le matériel suivant avant de commencer :

• Visual Studio est installé sur votre machine.
• La dernière version de .NET Framework est installée.

Étape 1 : Créer un nouveau projet dans Microsoft Visual Studio

Commençons maintenant par créer un nouveau projet Visual Studio.

Sélectionnez le modèle d'application Console sur l'écran ci-dessous.

Fournissez le nom et l'emplacement du projet.

Sélectionnez la version .NET, de préférence la plus récente compatible, puis cliquez sur Créer.

Étape 2 : Installer IronWord à l'aide du gestionnaire de packages NuGet

Installez le package NuGet IronWord à partir du gestionnaire de packages NuGet comme indiqué ci-dessous dans Visual Studio.

Vous pouvez également l'installer directement via l'interface de ligne de commande (CLI) en utilisant la commande ci-dessous.

dotnet add package IronWord --version 2024.9.1

Étape 3 : Générer un document Word avec alignement du texte

L'exemple de code ci-dessous montre comment générer un document Word avec du texte centré.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new document
        var document = new WordDocument();

        // Create a paragraph and add text
        Paragraph paragraph = new Paragraph();
        Text text = new Text() { Text = "IronWord, From IronSoftware" };
        paragraph.AddText(text); // Add text to the paragraph

        // Set text alignment to center aligned
        paragraph.Alignment = IronWord.Models.Enums.TextAlignment.Center;

        // Add the first paragraph to the document
        document.AddParagraph(paragraph);

        // Save the document with the specified filename
        document.SaveAs("output.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new document
        var document = new WordDocument();

        // Create a paragraph and add text
        Paragraph paragraph = new Paragraph();
        Text text = new Text() { Text = "IronWord, From IronSoftware" };
        paragraph.AddText(text); // Add text to the paragraph

        // Set text alignment to center aligned
        paragraph.Alignment = IronWord.Models.Enums.TextAlignment.Center;

        // Add the first paragraph to the document
        document.AddParagraph(paragraph);

        // Save the document with the specified filename
        document.SaveAs("output.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Set your license key for IronWord
		License.LicenseKey = "your key"

		' Create a new document
		Dim document = New WordDocument()

		' Create a paragraph and add text
		Dim paragraph As New Paragraph()
		Dim text As New Text() With {.Text = "IronWord, From IronSoftware"}
		paragraph.AddText(text) ' Add text to the paragraph

		' Set text alignment to center aligned
		paragraph.Alignment = IronWord.Models.Enums.TextAlignment.Center

		' Add the first paragraph to the document
		document.AddParagraph(paragraph)

		' Save the document with the specified filename
		document.SaveAs("output.docx")
	End Sub
End Class

Explication du code

1. Initialisez une nouvelle instance WordDocument.
2. Créez un objet texte avec le contenu souhaité.
3. Ajoutez le texte à un paragraphe.
4. Alignez le paragraphe en utilisant IronWord.Models.Enums.TextAlignment.Center.
5. Ajoutez le paragraphe à l'instance WordDocument et enregistrez le document sous output.docx.

Sortie

Étape 4 : Explorer la propriété d'alignement du texte dans IronWord

Essayons maintenant différentes options.

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

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new DOCX document
        var doc = new WordDocument();

        // Sample text for alignment
        Text text = new Text() { Text = "IronWord, From IronSoftware" };

        // Add paragraphs with different alignments
        AddPara(doc, text, TextAlignment.Center);
        AddPara(doc, text, TextAlignment.Left);
        AddPara(doc, text, TextAlignment.Right);
        AddPara(doc, text, TextAlignment.Justified);

        // Save the document with all alignment options
        doc.SaveAs("outputAllOptions.docx");
    }

    // Method to add a paragraph to the document with specified alignment
    private static void AddPara(WordDocument doc, Text text, TextAlignment alignment)
    {
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(text);
        paragraph.Alignment = alignment;
        doc.AddParagraph(paragraph);
    }
}

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

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new DOCX document
        var doc = new WordDocument();

        // Sample text for alignment
        Text text = new Text() { Text = "IronWord, From IronSoftware" };

        // Add paragraphs with different alignments
        AddPara(doc, text, TextAlignment.Center);
        AddPara(doc, text, TextAlignment.Left);
        AddPara(doc, text, TextAlignment.Right);
        AddPara(doc, text, TextAlignment.Justified);

        // Save the document with all alignment options
        doc.SaveAs("outputAllOptions.docx");
    }

    // Method to add a paragraph to the document with specified alignment
    private static void AddPara(WordDocument doc, Text text, TextAlignment alignment)
    {
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(text);
        paragraph.Alignment = alignment;
        doc.AddParagraph(paragraph);
    }
}

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

Friend Class Program
	Shared Sub Main()
		' Set your license key for IronWord
		License.LicenseKey = "your key"

		' Create a new DOCX document
		Dim doc = New WordDocument()

		' Sample text for alignment
		Dim text As New Text() With {.Text = "IronWord, From IronSoftware"}

		' Add paragraphs with different alignments
		AddPara(doc, text, TextAlignment.Center)
		AddPara(doc, text, TextAlignment.Left)
		AddPara(doc, text, TextAlignment.Right)
		AddPara(doc, text, TextAlignment.Justified)

		' Save the document with all alignment options
		doc.SaveAs("outputAllOptions.docx")
	End Sub

	' Method to add a paragraph to the document with specified alignment
	Private Shared Sub AddPara(ByVal doc As WordDocument, ByVal text As Text, ByVal alignment As TextAlignment)
		Dim paragraph As New Paragraph()
		paragraph.AddText(text)
		paragraph.Alignment = alignment
		doc.AddParagraph(paragraph)
	End Sub
End Class

Explication du code

1. Initialisez une nouvelle instance WordDocument.
2. Créez un objet texte avec le contenu souhaité.
3. Pour chaque option d'alignement (centré, gauche, droite, justifié), ajoutez le texte à un paragraphe et définissez l'alignement.
4. Ajoutez le paragraphe à l'instance WordDocument.
5. Enregistrez le document avec toutes les options d'alignement sous outputAllOptions.docx.

Sortie

Licences IronWord

La bibliothèque IronWord est l'un des produits de la suite Iron Suite d'Iron Software. Il lui faut une licence pour fonctionner. Un utilisateur peut télécharger une licence d'essai en utilisant son adresse électronique depuis la page de licence d'essai . Une fois les données saisies, la licence est envoyée à l'adresse électronique de l'utilisateur. Cette licence doit être placée au début du code utilisateur avant d'utiliser la bibliothèque IronWord, comme ci-dessous.

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here"

Conclusion

Le package NuGet IronWord simplifie le processus de travail avec les documents Word dans les applications .NET. Son API intuitive permet aux développeurs de manipuler facilement l'alignement du texte et d'autres éléments du document. Que vous ayez besoin d'aligner du texte à gauche, au centre ou à droite, ou de le justifier, IronWord vous fournit les outils nécessaires pour créer des documents professionnels et bien formatés.