Premiers pas avec IronWord

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

IronWord : bibliothèque de documents Word pour .NET

IronWord est une bibliothèque de documents Word développée par Iron Software. IronWord excelle dans la fourniture de fonctionnalités robustes pour travailler avec des documents Word dans des applications .NET.

  • Charger, manipuler et enregistrer des documents Word et Docx.
  • PageSetup : Configuration du format de papier, de l'orientation de la page, des marges et de la couleur de fond.
  • TextRun : Gestion du contenu textuel, des styles, du fractionnement, de l'ajout de texte et d'images.
  • TextStyle : Gestion de la famille de polices, de la taille, de la couleur, du gras, de l'italique, du barré, du souligné, des exposants et des indices.
  • Paragraph : Ajout de blocs de texte, d'images, de formes, définition des styles, des alignements, des puces et des listes numérotées.
  • Table : Manipulation de la structure du tableau, y compris l'ajout de lignes, l'obtention et la définition des valeurs des cellules, la suppression de lignes, la fusion de cellules, etc.
  • Image : Chargement d'images à partir de fichiers ou de flux, définition du retour à la ligne du texte, du décalage de position, de la largeur, de la hauteur et d'autres propriétés.
  • Shape : Paramétrage du texte à l'horizontale, du décalage de position, de la largeur, de la hauteur, du type de forme et de la rotation.

Installation

Bibliothèque IronWord

L'installation d'IronWord est rapide et facile. Vous pouvez installer le package à l'aide de NuGet avec la commande suivante :

Install-Package IronWord

Vous pouvez également télécharger directement depuis le site Web officiel d'IronWord NuGet .

Une fois installé, vous pouvez commencer en ajoutant using IronWord; en haut de votre fichier de code C#.

Application de la clé de licence

Ensuite, appliquez une clé de licence ou d'essai valide à IronWord en attribuant la clé de licence à la propriété LicenseKey de la classe License . Incluez le code suivant juste après l'instruction d'importation, avant d'utiliser toute méthode IronWord :

using IronWord;

// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";
using IronWord;

// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";
Imports IronWord

' Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"
$vbLabelText   $csharpLabel

Exemples de code

Explorons quelques exemples de code et les fonctionnalités disponibles.

Veuillez noterLe fichier DOCX produit par IronWord, lorsqu'il est ouvert dans une certaine version de Microsoft Word, peut être en mode de compatibilité , ce qui rend certains styles indisponibles. Pour convertir un document Word en mode de compatibilité@@--BRACKET-FERME--@@

  1. Sélectionnez " Fichier " > " Informations " et cliquez sur " Convertir ".
  2. Un message vous indiquera que votre document sera mis à niveau vers le format de fichier le plus récent. Cliquez sur " OK ".

Créer des documents Word et Docx

Créez le document Word en instanciant la classe WordDocument à l'aide de l'un de ses constructeurs. Ensuite, utilisez la méthode SaveAs pour exporter le document Word. Exemple :

using IronWord;

class Program
{
    static void Main()
    {
        // Create a new Word document
        var document = new WordDocument();

        // Save the document as a .docx file
        document.SaveAs("example.docx");
    }
}
using IronWord;

class Program
{
    static void Main()
    {
        // Create a new Word document
        var document = new WordDocument();

        // Save the document as a .docx file
        document.SaveAs("example.docx");
    }
}
Imports IronWord

Friend Class Program
	Shared Sub Main()
		' Create a new Word document
		Dim document = New WordDocument()

		' Save the document as a .docx file
		document.SaveAs("example.docx")
	End Sub
End Class
$vbLabelText   $csharpLabel

Ajouter une image

Une image ne peut pas être ajoutée seule ; Il devrait plutôt être ajouté à l'une des structures du document, comme un Paragraph , TableCell ou Section . Utilisez la méthode AddImage pour ajouter une image. Exemple :

using IronWord;
using System.Drawing;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();

        // Add an image to a paragraph
        var paragraph = section.Paragraphs.Add();
        paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));

        document.SaveAs("example_with_image.docx");
    }
}
using IronWord;
using System.Drawing;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();

        // Add an image to a paragraph
        var paragraph = section.Paragraphs.Add();
        paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));

        document.SaveAs("example_with_image.docx");
    }
}
Imports IronWord
Imports System.Drawing

Friend Class Program
	Shared Sub Main()
		Dim document = New WordDocument()
		Dim section = document.Sections.Add()

		' Add an image to a paragraph
		Dim paragraph = section.Paragraphs.Add()
		paragraph.AddImage("path/to/image.jpg", New Rectangle(0, 0, 100, 100))

		document.SaveAs("example_with_image.docx")
	End Sub
End Class
$vbLabelText   $csharpLabel

Ajouter un tableau

L'ajout d'un tableau nécessite la création du tableau, des lignes, des colonnes et des cellules du tableau. Cela offre d'importantes possibilités de configuration, chaque cellule pouvant avoir des styles différents. Exemple :

using IronWord;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();
        var table = section.Tables.Add(3, 3); // 3x3 table

        // Iterate over cells and set their content
        for (int i = 0; i < table.Rows.Count; i++)
        {
            for (int j = 0; j < table.Rows[i].Cells.Count; j++)
            {
                table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
            }
        }

        document.SaveAs("example_with_table.docx");
    }
}
using IronWord;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();
        var table = section.Tables.Add(3, 3); // 3x3 table

        // Iterate over cells and set their content
        for (int i = 0; i < table.Rows.Count; i++)
        {
            for (int j = 0; j < table.Rows[i].Cells.Count; j++)
            {
                table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
            }
        }

        document.SaveAs("example_with_table.docx");
    }
}
Imports IronWord

Friend Class Program
	Shared Sub Main()
		Dim document = New WordDocument()
		Dim section = document.Sections.Add()
		Dim table = section.Tables.Add(3, 3) ' 3x3 table

		' Iterate over cells and set their content
		For i As Integer = 0 To table.Rows.Count - 1
			Dim j As Integer = 0
			Do While j < table.Rows(i).Cells.Count
				table.Rows(i).Cells(j).Paragraphs.Add().AppendText($"Cell {i+1},{j+1}")
				j += 1
			Loop
		Next i

		document.SaveAs("example_with_table.docx")
	End Sub
End Class
$vbLabelText   $csharpLabel

Licence et support disponibles

IronWord est une bibliothèque payante ; Toutefois, des licences d'essai gratuites sont disponibles ici .

Pour plus d'informations sur Iron Software, veuillez consulter notre site web :https://ironsoftware.com/ . Pour plus d'assistance et pour toute question, veuillez contacter notre équipe .

Assistance d'Iron Software

Pour toute assistance générale et questions techniques, veuillez nous contacter par e-mail à l'adresse suivante :support@ironsoftware.com

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 27,129 | Version: 2025.11 vient de sortir