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

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 récupérer des images qui pourraient ê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

Friend Class Program
	Shared 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 Class

Ajouter des tableaux : Les tableaux sont un élément essentiel des fichiers DOCX et sont facilement manipulables avec IronWord, prenant 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

Friend Class Program
	Shared 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 Class

API Word .NET (Fonctionnement pour les développeurs) : Figure 1 - PDF généré avec un tableau

É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

Friend Class Program
	Shared 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,
			.Height = 200
		}

		' 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 Class

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é.

Versions .NET et types de projets

API .NET Word (Fonctionnement pour les développeurs) : Figure 2 - Versions .NET et types de projets compatibles avec IronWord

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

API .NET Word (Fonctionnement pour les développeurs) : Figure 3 - Environnements d'application compatibles avec IronWord

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)

! API Word .NET (Fonctionnement pour les développeurs) : Figure 4 - IronWord du système d'exploitation et de l'IDE est compatible avec

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.

Licence Lite

Cette option est conçue sur mesure pour les développeurs individuels travaillant seuls sur un projet. Son prix est de $799 et elle couvre un développeur sur un seul site.

Licence Plus

Destinée aux petites équipes, cette licence, pour $plusLicense, 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 $professionalLicense 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.