L' API .NET Word offre aux développeurs des outils robustes pour convertir des documents Word, interagir avec eux et les manipuler au sein de leurs applications. Cette API est conçue pour simplifier le processus de travail avec les documents Microsoft Word, facilitant ainsi la création, la modification, la conversion et la gestion programmatique des documents. Dans cet article, nous explorerons IronWord afin de comprendre ses capacités de manipulation des documents Word.

Introduction à IronWord

IronWord est une bibliothèque Word .NET faisant partie de l'écosystème de l'API Word .NET, conçue spécifiquement pour les développeurs qui traitent des documents Microsoft Word dans leurs applications .NET. Avec IronWord, les développeurs peuvent facilement lire, écrire et modifier des documents Word sans avoir besoin d'installer Microsoft Word sur le serveur ou les machines clientes. Cette fonctionnalité est particulièrement utile pour les applications qui doivent automatiser les tâches de traitement de documents, telles que la génération de rapports, de factures ou de correspondance personnalisée grâce aux fonctionnalités de publipostage.

Caractéristiques d'IronWord

IronWord offre une gamme complète de fonctionnalités qui répondent aux différents aspects de la manipulation des documents Word. Explorons chaque ensemble de fonctionnalités, en nous concentrant sur la manière dont elles permettent la manipulation et la fusion de plusieurs documents, classés sous " Structure du document " et " Éléments du document ".

Structure du document

Lire et modifier des documents Word : Avec IronWord, vous pouvez extraire des informations spécifiques de vos documents Word, comme du texte à modifier ou à réutiliser, et des images pouvant être utilisées ailleurs. Cette fonctionnalité est essentielle pour les applications visant à fusionner des documents Word et à traiter les informations contenues dans des fichiers DOCX existants.

Formats multiples : IronWord prend en charge un large éventail de formats de fichiers, ce qui améliore son utilité pour la conversion de documents Word au sein d'applications .NET .

Mise en page : Personnaliser la mise en page de vos documents Word est simple avec IronWord. Vous pouvez ajuster le format du papier de différents fichiers MS Word selon des dimensions standard ou personnalisées, modifier l'orientation de différentes sections de votre document, définir les marges pour assurer un alignement correct et même modifier la couleur d'arrière-plan à des fins esthétiques ou pour mettre en évidence des sections.

Ajout de paragraphes : IronWord permet d'ajouter et de supprimer des blocs de texte à l'intérieur des paragraphes , ce qui est essentiel pour éditer et mettre en forme de grandes sections de texte. De plus, vous pouvez améliorer vos paragraphes en insérant des images et des formes directement dans le texte, en ajustant le style pour qu'il corresponde à vos spécifications de conception et en définissant des alignements pour un aspect soigné. La possibilité d'ajouter des puces et des listes numérotées contribue également à une meilleure organisation du contenu.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();
        
        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
        
        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
        
        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
        
        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();
        
        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
        
        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
        
        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
        
        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Load docx
        Dim doc As New WordDocument()
        ' Create and add styled text to a paragraph
        Dim paragraph As New Paragraph()
        
        ' Adding regular text
        paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
        
        ' Adding italic text
        paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
        
        ' Adding bold text
        paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
        
        ' Add paragraph to the document and export docx
        doc.AddParagraph(paragraph)
        doc.SaveAs("newdocument.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Load docx
        Dim doc As New WordDocument()
        ' Create and add styled text to a paragraph
        Dim paragraph As New Paragraph()
        
        ' Adding regular text
        paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
        
        ' Adding italic text
        paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
        
        ' Adding bold text
        paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
        
        ' Add paragraph to the document and export docx
        doc.AddParagraph(paragraph)
        doc.SaveAs("newdocument.docx")
    End Sub
End Module

Ajouter des tableaux : Les tableaux sont un élément essentiel des fichiers DOCX et sont facilement manipulables avec IronWord, qui prend en charge la génération dynamique de documents. Vous pouvez ajouter ou supprimer des lignes et des colonnes, une opération essentielle pour la génération dynamique de documents où la quantité de données peut varier. La fusion et la division des cellules vous offrent la flexibilité nécessaire pour formater des tableaux complexes, et la personnalisation des bordures et des dimensions de la mise en page permet d'obtenir un aspect soigné et professionnel.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
        
        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };
        
        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };
        
        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);
        
        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
        
        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };
        
        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };
        
        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);
        
        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a table cell with a paragraph containing text
        Dim cell As New TableCell(New Paragraph(New TextRun("Sample text")))

        ' Configure a common border style for the table
        Dim borderStyle As New BorderStyle With {
            .BorderColor = New IronColor(IronSoftware.Drawing.Color.Black),
            .BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            .BorderSize = 5
        }

        ' Apply the border style to the cell
        cell.Borders = New TableBorders With {
            .TopBorder = borderStyle,
            .RightBorder = borderStyle,
            .BottomBorder = borderStyle,
            .LeftBorder = borderStyle
        }

        ' Create a table row and add the same cell twice
        Dim row As New TableRow()
        row.AddCell(cell)
        row.AddCell(cell)

        ' Create a table, add the row, then create and export the Word document
        Dim table As New Table()
        table.AddRow(row)
        Dim doc As New WordDocument(table)
        doc.SaveAs("Document.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a table cell with a paragraph containing text
        Dim cell As New TableCell(New Paragraph(New TextRun("Sample text")))

        ' Configure a common border style for the table
        Dim borderStyle As New BorderStyle With {
            .BorderColor = New IronColor(IronSoftware.Drawing.Color.Black),
            .BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            .BorderSize = 5
        }

        ' Apply the border style to the cell
        cell.Borders = New TableBorders With {
            .TopBorder = borderStyle,
            .RightBorder = borderStyle,
            .BottomBorder = borderStyle,
            .LeftBorder = borderStyle
        }

        ' Create a table row and add the same cell twice
        Dim row As New TableRow()
        row.AddCell(cell)
        row.AddCell(cell)

        ' Create a table, add the row, then create and export the Word document
        Dim table As New Table()
        table.AddRow(row)
        Dim doc As New WordDocument(table)
        doc.SaveAs("Document.docx")
    End Sub
End Module

Éléments du document

Ajouter des TextRuns : cette fonctionnalité permet un contrôle précis du contenu textuel. Vous pouvez ajouter, compléter et diviser des séquences de texte, ce qui est essentiel pour la création de documents dynamiques. Les options de style sont nombreuses et comprennent la modification des polices, des tailles et des couleurs, ainsi que l'ajout de gras, d'italique et d'autres décorations de texte. Vous pouvez également intégrer des images dans des blocs de texte, créant ainsi un document riche et visuellement attrayant.

Ajouter des images : IronWord permet une manipulation complète des images dans les documents Word. Vous pouvez charger des images provenant de diverses sources, les entourer de texte de manière fluide et ajuster leurs dimensions en fonction de votre mise en page. La possibilité de régler le décalage de position et la distance par rapport aux coins du document garantit que vos images seront toujours parfaitement positionnées.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();
        
        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };
        
        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);
        
        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();
        
        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };
        
        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);
        
        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        Dim doc As New WordDocument()
        
        ' Load and configure the image
        Dim image As New IronWord.Models.Image("your-image.jpg") With {
            .Width = 200, ' In unit pixels
            .Height = 200 ' In unit pixels
        }
        
        ' Create paragraph, add image, add paragraph to document, and export
        Dim paragraph As New Paragraph()
        paragraph.AddImage(image)
        
        ' Add paragraph containing the image to the document
        doc.AddParagraph(paragraph)
        doc.SaveAs("save_document.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        Dim doc As New WordDocument()
        
        ' Load and configure the image
        Dim image As New IronWord.Models.Image("your-image.jpg") With {
            .Width = 200, ' In unit pixels
            .Height = 200 ' In unit pixels
        }
        
        ' Create paragraph, add image, add paragraph to document, and export
        Dim paragraph As New Paragraph()
        paragraph.AddImage(image)
        
        ' Add paragraph containing the image to the document
        doc.AddParagraph(paragraph)
        doc.SaveAs("save_document.docx")
    End Sub
End Module

Ajouter des formes : les formes peuvent apporter un impact visuel significatif à un document, et IronWord vous fournit les outils nécessaires pour les insérer et les personnaliser avec précision. Vous pouvez définir le type de forme (rectangles, cercles, flèches, etc.), déterminer comment le texte doit s'enrouler autour de la forme, spécifier les dimensions et le positionnement exacts, et même faire pivoter les formes pour obtenir l'effet visuel souhaité.

Compatibilité

Versions .NET et types de projets

IronWord est conçu pour une large compatibilité au sein de l'écosystème .NET, prenant en charge C#, VB.NET et F# sur différentes versions de .NET, notamment .NET Core, .NET Standard et .NET Framework. Cela garantit son utilité aussi bien dans les applications modernes que dans les applications plus anciennes. La polyvalence de la bibliothèque s'étend aux types de projets, prenant en charge les applications web, mobiles et de bureau grâce à son intégration avec Blazor, WebForms, Xamarin, MAUI, WPF et les applications console.

Environnements d'applications

En termes d'environnements d'application, IronWord est adaptable aux plateformes Windows, Linux, iOS et Android, avec une prise en charge spécifique de la conteneurisation et du déploiement cloud sur Docker, Azure et AWS. Ce soutien étendu facilite le développement dans différents environnements.

Système d'exploitation et environnement de développement intégré (IDE)

IronWord est également compatible avec les principaux environnements de développement intégrés (IDE) tels que Microsoft Visual Studio, ReSharper et Rider, offrant ainsi aux développeurs une grande flexibilité dans le choix de leurs outils. Enfin, il prend en charge divers systèmes d'exploitation et architectures de processeurs (x64, x86, ARM), garantissant des performances efficaces sur diverses configurations matérielles.

Options de licence

IronWord propose différentes options de licence pour répondre aux besoins des différents développeurs et organisations. Ils proposent une licence perpétuelle, ce qui signifie que vous payez une seule fois et qu'il n'y a pas de frais récurrents. Chaque licence inclut un an d'assistance produit et de mises à jour. Les différents niveaux de licence sont conçus en fonction du nombre de développeurs, de sites et de projets que vous avez. Vous pouvez également bénéficier d'un essai gratuit pour vous familiariser avec le produit avant d'acheter une licence.

Licence Lite

Cette option est conçue sur mesure pour les développeurs individuels travaillant seuls sur un projet. Il est au prix de $999 et couvre un développeur dans un seul emplacement.

Licence Plus

Destinée aux petites équipes, cette licence, pour $1,499, permet de travailler avec jusqu'à trois développeurs et est valable pour une utilisation sur trois sites et trois projets.

Licence professionnelle

Pour les équipes plus importantes, la licence professionnelle est proposée au prix de $2,399 et prend en charge jusqu'à dix développeurs. Il est conçu pour répondre aux besoins d'opérations plus importantes et comprend des fonctionnalités d'assistance premium.

Conclusion

En conclusion, IronWord se présente comme une API Word .NET robuste et flexible, offrant une gamme d'options de licence pour répondre aux divers besoins des développeurs individuels et des équipes. Ses fonctionnalités permettent une gestion et une manipulation efficaces des documents Word, assurant la compatibilité avec plusieurs versions de .NET et types de projets.