IronWord 2024.4.1

IronWord - The C# Word Library

IronWord is a library developed and maintained by Iron Software that helps C# Software Engineers to load, manipulate, and save Word document in .NET applications & websites.

IronWord excels at:

• Loading, manipulating, and saving Word and DOCX documents.
• PageSetup: Configuring paper size, page orientation, margins, and background color.
• TextRun: Handling text content, styles, splitting, appending text, and adding images.
• TextStyle: Managing font family, size, color, bold, italic, strikethrough, underline, superscript, and subscript.
• Paragraph: Adding text runs, images, shapes, setting styles, alignments, bullets, and numbering lists.
• Table: Manipulating table structure, including adding rows, getting and setting cell values, removing rows, merging cells, and more.
• Image: Loading images from files or streams, setting wrap text, position offset, width, height, and other properties.
• Shape: Setting wrap text, position offset, width, height, shape type, and rotation.

And much more! Visit our website to see all our code examples and a full list of our features

IronWord Has Cross Platform Support Compatibility With:

• .NET 8, .NET 7, .NET 6 and .NET 5, Core 2x & 3x, Standard 2, and Framework 4.6.2+
• Windows, macOS, Linux, Docker, Azure, and AWS

Our API reference and full licensing information can be found easily on our website.

Using IronWord

You can install the IronWord NuGet package by simply entering this command in your package manager console:

PM> Install-Package IronWord

Once installed, add using IronWord; to the top of your C# code. Here is a code example to get started with loading, editing, and saving a document:

using IronWord;
using IronWord.Models;
using IronSoftware.Drawing;

// Load an existing DOCX
var docx1 = new WordDocument("existing.docx");

// Or, make a new DOCX
var docx_new = new WordDocument();

// Add a paragraph with text
Paragraph paragraph = new();
var textRun = new TextRun()
{
    Text = "Hello IronWord!"
};
paragraph.AddTextRun(textRun);

docx1.AddParagraph(paragraph);

// Add a paragraph with an image
TextRun textRunWithImage = new TextRun();
Image image = new Image("example.jpg");
image.Width = 400; // px
image.Height = 300; // px
image.Position = new ElementPosition() {
    X = 0, // pts
    Y = 72  // pts
};
textRunWithImage.AddChild(image);
docx1.AddParagraph(new Paragraph(textRunWithImage));

// Save over the existing DOCX
docx1.Save("existing.docx");

// Or save as a new DOCX
docx1.SaveAs("output.docx");

Features Table

Licensing & Support available

For our full list of code examples, tutorials, licensing information, and documentation visit: https://ironsoftware.com/csharp/word/

For support please email us at: support@ironsoftware.com

Documentation Links

• How-To Guides : https://ironsoftware.com/csharp/word/how-to/
• Code Examples : https://ironsoftware.com/csharp/word/examples/
• API Reference : https://ironsoftware.com/csharp/word/object-reference/api/
• Tutorials : https://ironsoftware.com/csharp/word/tutorials/
• Licensing : https://ironsoftware.com/csharp/word/licensing/
• Live Chat Support : https://ironsoftware.com/csharp/word/#helpscout-support