.NET Word API (Comment ça marche pour les développeurs)

Introduction

L'API .NET Word offre aux développeurs des outils puissants pour convertir des documents Word, interagir avec et manipuler des documents MS Word au sein de leurs applications. Cette API est conçue pour rationaliser le processus de travail avec les documents Microsoft Word, en facilitant la création, l'édition, la conversion et la gestion des documents de manière programmatique. Dans cet article, nous explorerons IronWord pour comprendre ses capacités à manipuler des documents Word.

Introduction à IronWord

IronWord est une bibliothèque Word .NET au sein 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 que Microsoft Word soit installé sur le serveur ou les machines clientes. Cette capacité est particulièrement utile pour les applications qui doivent automatiser les tâches de traitement des documents, telles que la génération de rapports, de factures ou de courriers personnalisés par le biais de fonctionnalités de fusion de courrier.

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. Nous allons explorer chaque ensemble de fonctionnalités, en nous concentrant sur la façon dont elles permettent la manipulation et la fusion de plusieurs documents, classés dans les catégories "Structure du document" et "Éléments du document".

Structure du document

Lire et éditer Word : Avec IronWord, vous pouvez extraire des informations spécifiques de vos documents Word, telles que l'extraction de texte pour l'édition ou la réutilisation, ainsi que la récupération d'images pouvant être nécessaires ailleurs. Cette capacité est essentielle pour les applications visant à fusionner des documents Word et à traiter les informations contenues dans les fichiers DOCX existants.

Formats multiples : IronWord prend en charge une large gamme de formats de fichiers, augmentant ainsi son utilité pour convertir des documents Word au sein des applications .NET.

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

Ajouter des paragraphes : IronWord permet l'ajout et la suppression de segments de texte à l'intérieur des paragraphes, ce qui est essentiel pour éditer et formater de grandes sections de texte. En outre, 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 une apparence soignée. La possibilité d'ajouter des puces et des listes de numéros permet également d'organiser le contenu de manière plus efficace.

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

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

Imports IronWord
Imports IronWord.Models
' Load docx
Private doc As New WordDocument()
' Create and add styled text to a paragraph
Private paragraph As New Paragraph()
paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
' Add paragraph and export docx
doc.AddParagraph(paragraph)
doc.SaveAs("newdocument.docx")

Ajouter des tableaux : Tableaux sont un élément essentiel des fichiers DOCX et sont facilement manipulés avec IronWord, soutenant 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 de cellules vous permettent de mettre en forme des tableaux complexes, et la personnalisation des bordures et des dimensions de la mise en page permet d'obtenir un aspect professionnel et soigné.

using IronWord;
using IronWord.Models;
// 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;
// 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
' Create a table cell with a paragraph containing text
Private cell As New TableCell(New Paragraph(New TextRun("Sample text")))
' Configure a common border style for the table
Private 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")

Éléments du document

Ajouter des TextRuns : Cette fonctionnalité offre un contrôle précis sur le contenu textuel. Il est possible d'ajouter, d'annexer et de diviser des séquences de texte, ce qui est essentiel pour la création de documents dynamiques. Les options de style sont nombreuses et permettent notamment de modifier les familles de polices, les tailles et les couleurs, ainsi que d'ajouter du gras, de l'italique et d'autres décorations de texte. Vous pouvez également intégrer des images dans des séries de texte, créant ainsi un document riche et visuellement attrayant.

Ajouter des images : IronWord permet une manipulation exhaustive des images dans les documents Word. Vous pouvez charger des images à partir de différentes sources, les entourer de texte de manière transparente et ajuster leurs dimensions pour les adapter à votre mise en page. La possibilité de définir le décalage de la position et la distance par rapport aux coins du document signifie que vos images seront toujours parfaitement placées.

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, // In unit pixel
    Height = 200 // In unit pixel
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, // In unit pixel
    Height = 200 // In unit pixel
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
Private doc As New WordDocument()
Private image As New IronWord.Models.Image("your-image.jpg") With {
	.Width = 200,
	.Height = 200
}
Private paragraph, add, add, [and] As Create
paragraph.AddImage(image)
doc.AddParagraph(paragraph)
doc.SaveAs("save_document.docx")

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

Compatibilité

versions et types de projets .NET

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é dans les applications contemporaines et anciennes. La polyvalence de la bibliothèque s'étend aux types de projets, s'adaptant aux applications web, mobiles et de bureau grâce à l'intégration avec Blazor, WebForms, Xamarin, MAUI, WPF et les applications de console.

Environnements applicatifs

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

SYSTÈME D'EXPLOITATION ET 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 aux développeurs une flexibilité dans leur choix d'outils. Enfin, il prend en charge divers systèmes d'exploitation et architectures de processeur (x64, x86, ARM), garantissant une performance efficace à travers différentes configurations matérielles.

Options de licence

IronWord propose diverses 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 fois et qu'il n'y a pas de frais récurrents. Chaque licence comprend un an d'assistance et de mises à jour du produit. Les niveaux de licence sont conçus en fonction du nombre de développeurs, de sites et de projets que vous avez. Vous pouvez également obtenir une version d'essai gratuite pour acquérir une expérience pratique avant d'acheter une licence.

License Lite

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

License Plus

Destinée aux petites équipes, cette licence, d'un montant de 1 499 dollars, permet d'accueillir jusqu'à trois développeurs et peut être utilisée sur trois sites dans le cadre de trois projets.

Licence professionnelle

Pour les équipes plus importantes, la licence professionnelle est proposée au prix de 2 999 dollars 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 fonctions d'assistance de premier ordre.

Conclusion

En conclusion, IronWord se révèle être 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 de gérer et de manipuler efficacement les documents Word, tout en garantissant la compatibilité avec de multiples versions .NET et types de projets.