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

Introduction

Les .NET Word API fournit aux développeurs des outils robustes pour convertir les documents Word, interagir avec eux et les manipuler dans 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 .NET Word au sein de l'écosystème .NET Word API, 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, par exemple extraire du texte pour le modifier ou le réorganiser et récupérer des images qui pourraient devoir être utilisées 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 un large éventail de formats de fichiers, ce qui renforce son utilité dans la conversion de documents Word au sein d'applications .NET.

Édition de la mise en page : Avec IronWord, il est facile d'adapter la mise en page de vos documents Word. 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 le texte court à l'intérieur des paragraphesqui est essentielle pour l'édition et la mise en forme 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 : Tables sont un élément essentiel des fichiers DOCX et sont facilement manipulés avec IronWord, ce qui permet de générer des documents dynamiques. 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é permet de contrôler finement le contenu du texte. 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 d'ajouter des images de façon complète manipulation d'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 ajouter un impact visuel important à un document, et IronWord vous donne les outils pour les insérer et les personnaliser avec précision. Vous pouvez définir le type de forme (comme des rectangles, des cercles, des flèches, etc.)vous pouvez ainsi 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 désiré.

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é (IDE) tels que Microsoft Visual Studio, ReSharper et Rider, ce qui offre aux développeurs une certaine souplesse dans le choix de leurs outils. Enfin, il prend en charge différents systèmes d'exploitation et architectures de processeurs (x64, x86, ARM)le système de gestion de l'information de l'Union européenne (UE) permet d'assurer des performances efficaces dans diverses 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 un essai gratuit 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. Le prix est de $749 et couvre un développeur dans un seul endroit.

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 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 de gérer et de manipuler efficacement les documents Word, tout en garantissant la compatibilité avec de multiples versions .NET et types de projets.