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 permettant de travailler avec des documents Word dans des applications .NET.

  • Charger, manipuler et enregistrer des documents Word et Docx.
  • Mise en page : Configuration du format du papier, de l'orientation de la page, des marges et de la couleur d'arrière-plan.
  • TextRun : Gestion du contenu du texte, des styles, de la division, de l'ajout de texte et de l'ajout d'images.
  • TextStyle : Gestion de la famille de polices, de la taille, de la couleur, du gras, de l'italique, du barré, du souligné, de l'exposant et de l'indice.
  • Paragraphe : Ajout de passages de texte, d'images, de formes, définition de styles, alignements, puces et numérotation de listes.
  • Tableau : Manipulation de la structure d'un 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 texte d'accompagnement, du décalage de position, de la largeur, de la hauteur et d'autres propriétés.
  • Forme : Réglage du texte d'habillage, 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 de l'IronWord est rapide et facile, veuillez installer le paquet comme suit :

Install-Package IronWord

Vous pouvez également télécharger directement à partir du site site officiel d'IronWord NuGet.

Une fois installé, vous pouvez commencer par ajouter utiliser IronWord; au début de votre code C#.

Application de la clé de licence

Ensuite, appliquez une licence valide ou une clé d'essai à 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 les méthodes IronWord :

:path=/static-assets/word/content-code-examples/get-started/get-started-license.cs
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01";
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01"
VB   C#

Exemples de codes

Le 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 éléments de style indisponibles. Pour convertir un document Word hors du mode de compatibilité :

  1. Sélectionnez "Fichier" > "Info" et cliquez sur "Convertir"

  2. Un message vous indique 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.

:path=/static-assets/word/content-code-examples/get-started/get-started-1.cs
using IronWord;
using IronWord.Models;

// Create textrun
Text textRun = new Text("Sample text");

Paragraph paragraph = new Paragraph();
paragraph.AddText(textRun);

// Create a new Word document
WordDocument doc = new WordDocument(paragraph);

// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models

' Create textrun
Private textRun As New Text("Sample text")

Private paragraph As New Paragraph()
paragraph.AddText(textRun)

' Create a new Word document
Dim doc As New WordDocument(paragraph)

' Export docx
doc.SaveAs("document.docx")
VB   C#

Ajouter une image

Une image ne peut pas être ajoutée seule ; au lieu de cela, il doit être ajouté à l'une des structures du document, comme un Paragraphe, un TableCell ou une Section. Utilisez la méthode AddImage pour ajouter une image.

:path=/static-assets/word/content-code-examples/get-started/get-started-2.cs
using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure image
IronWord.Models.Image image = new IronWord.Models.Image("image.jpg");
image.Width = 250; // In unit pixel
image.Height = 200; // In unit pixel
Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument("document.docx")

' Configure image
Private image As New IronWord.Models.Image("image.jpg")
image.Width = 250 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim paragraph As New Paragraph()

' Add image
paragraph.AddImage(image)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")
VB   C#

Ajouter une table

L'ajout d'un tableau nécessite un peu plus de travail, car le tableau, les lignes, les colonnes et les cellules du tableau doivent être créés. Toutefois, cette configuration offre d'importantes possibilités de configuration. Chaque cellule peut avoir un style différent. Explorez les différents styles de bordures, qui offrent une vaste sélection de 24 types.

:path=/static-assets/word/content-code-examples/get-started/get-started-3.cs
using IronWord;
using IronWord.Models;

// Create table cell
TableCell cell = new TableCell();

Text textRun = new Text();
textRun.Text = "Sample text";

// Add textrun to the cell
cell.AddChild(new Paragraph(textRun));

// Configure border style
BorderStyle borderStyle = new BorderStyle();
borderStyle.BorderColor = Color.Black;
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick;
borderStyle.BorderSize = 5;

// Configure table border
TableBorders tableBorders = new TableBorders() {
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle,
};

cell.Borders = tableBorders;

// Create row and add cell
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);

// Create table and add row
Table table = new Table();
table.AddRow(row);

// Create new Word document from the table
WordDocument doc = new WordDocument(table);

// Export Word document
doc.SaveAs("Document.docx");
Imports IronWord
Imports IronWord.Models

' Create table cell
Private cell As New TableCell()

Private textRun As New Text()
textRun.Text = "Sample text"

' Add textrun to the cell
cell.AddChild(New Paragraph(textRun))

' Configure border style
Dim borderStyle As New BorderStyle()
borderStyle.BorderColor = Color.Black
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick
borderStyle.BorderSize = 5

' Configure table border
Dim tableBorders As New TableBorders() With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}

cell.Borders = tableBorders

' Create row and add cell
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)

' Create table and add row
Dim table As New Table()
table.AddRow(row)

' Create new Word document from the table
Dim doc As New WordDocument(table)

' Export Word document
doc.SaveAs("Document.docx")
VB   C#

Licences et assistance disponibles

IronWord est une bibliothèque payante, mais des licences d'essai gratuites sont également disponibles ici.

Pour plus d'informations sur Iron Software, veuillez consulter notre site Web : https://ironsoftware.com/ Pour plus d'assistance et de demandes de renseignements, veuillez vous adresser à demandez à notre équipe.

Assistance d'Iron Software

Pour toute question d'ordre général ou technique, veuillez nous envoyer un courrier électronique à l'adresse suivante support@ironsoftware.com