IronWord Tutorials Document Element Document Element Tutorial Chaknith Bin Updated:June 22, 2025 IronWord is a powerful Word document library designed to assist .NET C# developers in integrating the capabilities of creating, reading, and editing Word and DOCX documents into their applications. In the context of a Word document, document elements are the building blocks that make up the content. Table of Contents Add Text Text Content (Add, Append & Split) Set Styling (Font Family & Size, Color, Bold & Italic, Strikethrough, Underline, Superscript & Subscript) Embed Images Add Images Load Image (File & FileStream) Set Wrap Text Set Dimensions (Width & Height) Set Position Offset Set Distance from Corners Get started with IronWord Start using IronWord in your project today with a free trial. First Step: Start for Free Add TextRuns Text Content The Split method is utilized to divide the text run into a list of smaller TextRuns, based on a specified delimiter. This allows for the organization and manipulation of textual information within the document. :path=/static-assets/word/content-code-examples/tutorials/add-textrun-text-content.cs using IronWord; using IronWord.Models; WordDocument doc = new WordDocument(); // Add text TextContent addText = new TextContent("Add text using IronWord"); doc.AddParagraph(new Paragraph(addText)); // Append text TextContent appendText = new TextContent("The first text."); appendText.Append(new TextContent("The second text.")); doc.AddParagraph(new Paragraph(appendText)); // Split text TextContent splitText = new TextContent("Use split to split the sentence."); splitText.Split(" "); doc.AddParagraph(new Paragraph(splitText)); // Export docx doc.SaveAs("textrun.docx"); Imports IronWord Imports IronWord.Models Private doc As New WordDocument() ' Add text Private addText As New TextContent("Add text using IronWord") doc.AddParagraph(New Paragraph(addText)) ' Append text Dim appendText As New TextContent("The first text.") appendText.Append(New TextContent("The second text.")) doc.AddParagraph(New Paragraph(appendText)) ' Split text Dim splitText As New TextContent("Use split to split the sentence.") splitText.Split(" ") doc.AddParagraph(New Paragraph(splitText)) ' Export docx doc.SaveAs("textrun.docx") $vbLabelText $csharpLabel Set Styling Setting styling for TextRuns allows you to define the visual presentation of text. This includes specifying attributes such as font size, color, style, strikethrough, underline, superscript, and subscript. Configuring styling enhances the overall appearance of the text in the document. :path=/static-assets/word/content-code-examples/tutorials/add-textrun-set-styling.cs using IronWord; using IronWord.Models; using IronWord.Models.Enums; // Load docx WordDocument doc = new WordDocument("document.docx"); // Configure text TextContent textRun = new TextContent(); textRun.Text = "Add text using IronWord"; textRun.Style = new TextStyle() { TextFont = new Font() { FontFamily = "Caveat", FontSize = 72, }, Color = Color.Red, IsBold = true, IsItalic = true, Underline = new Underline(), Strike = StrikeValue.Strike, }; Paragraph paragraph = new Paragraph(); // Add text paragraph.AddText(textRun); // Add paragraph doc.AddParagraph(paragraph); // Export docx doc.SaveAs("save_document.docx"); Imports IronWord Imports IronWord.Models Imports IronWord.Models.Enums ' Load docx Private doc As New WordDocument("document.docx") ' Configure text Private textRun As New TextContent() textRun.Text = "Add text using IronWord" textRun.Style = New TextStyle() With { .TextFont = New Font() With { .FontFamily = "Caveat", .FontSize = 72 }, .Color = Color.Red, .IsBold = True, .IsItalic = True, .Underline = New Underline(), .Strike = StrikeValue.Strike } Dim paragraph As New Paragraph() ' Add text paragraph.AddText(textRun) ' Add paragraph doc.AddParagraph(paragraph) ' Export docx doc.SaveAs("save_document.docx") $vbLabelText $csharpLabel Obtain Text Fill Color Aside from setting styling, IronWord provides a way for you to obtain the RGBA color value of the existing document to retain consistency throughout the styling. :path=/static-assets/word/content-code-examples/tutorials/rgba-color-value.cs using IronWord; using IronWord.Models; using System; // Open existing Word WordDocument doc = new WordDocument("Accent1TextThemcolor.docx"); TextContent content = doc.Paragraphs[0].Texts[0]; // This will show the R G B A of the themecolor var filledColor = content.FillColor; // Print the filled color variable to the console Console.WriteLine(filledColor); Imports IronWord Imports IronWord.Models Imports System ' Open existing Word Private doc As New WordDocument("Accent1TextThemcolor.docx") Private content As TextContent = doc.Paragraphs(0).Texts(0) ' This will show the R G B A of the themecolor Private filledColor = content.FillColor ' Print the filled color variable to the console Console.WriteLine(filledColor) $vbLabelText $csharpLabel We first import the document by initializing a new WordDocument, then access the Paragraphs array and the Texts Array to retrieve the Text property. The Text class then returns the FillColor to showcase the RGBA value of the existing color of the text. Embed Images This feature allows you to seamlessly include images within the content, enhancing the overall visual appeal and communicative power of the document. :path=/static-assets/word/content-code-examples/tutorials/add-textrun-embed-images.cs using IronWord; using IronWord.Models; // Load docx WordDocument doc = new WordDocument(); // Configure image ImageContent image = new ImageContent("image.jpg"); image.Width = 200; // In unit pixel image.Height = 200; // In unit pixel TextContent textRun = new TextContent(); // Add image Paragraph para = new Paragraph(textRun); para.AddImage(image); // Add paragraph doc.AddParagraph(new Paragraph(textRun)); // Export docx doc.SaveAs("save_document.docx"); Imports IronWord Imports IronWord.Models ' Load docx Private doc As New WordDocument() ' Configure image Private image As New ImageContent("image.jpg") image.Width = 200 ' In unit pixel image.Height = 200 ' In unit pixel Dim textRun As New TextContent() ' Add image Dim para As New Paragraph(textRun) para.AddImage(image) ' Add paragraph doc.AddParagraph(New Paragraph(textRun)) ' Export docx doc.SaveAs("save_document.docx") $vbLabelText $csharpLabel Add Images Load Image Loading images is a crucial process. This involves bringing external image files into the document. The ability to load images facilitates the inclusion of relevant visuals, contributing to a more engaging and informative document. :path=/static-assets/word/content-code-examples/tutorials/add-image-load-image.cs using IronWord; using IronWord.Models; // Load docx WordDocument doc = new WordDocument(); Paragraph paragraph = new Paragraph(); // Add image paragraph.AddImage("image.jpg"); // Add paragraph doc.AddParagraph(paragraph); // Export docx doc.SaveAs("document.docx"); Imports IronWord Imports IronWord.Models ' Load docx Private doc As New WordDocument() Private paragraph As New Paragraph() ' Add image paragraph.AddImage("image.jpg") ' Add paragraph doc.AddParagraph(paragraph) ' Export docx doc.SaveAs("document.docx") $vbLabelText $csharpLabel Configure Image Optimize the images with configurable settings. This includes setting properties such as text wrapping, dimensions, position, and distance from corners. Proper configuration ensures that images are displayed in a visually pleasing and contextually appropriate manner. :path=/static-assets/word/content-code-examples/tutorials/add-image-configure-image.cs using IronWord; using IronWord.Models; using IronWord.Models.Enums; // Load docx WordDocument doc = new WordDocument(); // Configure image ImageContent image = new ImageContent("image.jpg"); image.WrapText = WrapText.Square; image.Width = 100; image.Height = 100; image.DistanceFromTop = 50; var position = new ElementPosition(); position.X = 50; position.Y = 50; image.Position = position; Paragraph paragraph = new Paragraph(); // Add image paragraph.AddImage(image); // Add paragraph doc.AddParagraph(paragraph); // Export docx doc.SaveAs("document.docx"); Imports IronWord Imports IronWord.Models Imports IronWord.Models.Enums ' Load docx Private doc As New WordDocument() ' Configure image Private image As New ImageContent("image.jpg") image.WrapText = WrapText.Square image.Width = 100 image.Height = 100 image.DistanceFromTop = 50 Dim position = New ElementPosition() position.X = 50 position.Y = 50 image.Position = position Dim paragraph As New Paragraph() ' Add image paragraph.AddImage(image) ' Add paragraph doc.AddParagraph(paragraph) ' Export docx doc.SaveAs("document.docx") $vbLabelText $csharpLabel Frequently Asked Questions What is IronWord? IronWord is a powerful Word document library designed to assist .NET C# developers in integrating the capabilities of creating, reading, and editing Word and DOCX documents into their applications. How can I add text to a Word document? You can add a text run to a Word document by creating an instance of TextRun with your desired text and adding it to a document's paragraph using IronWord. How do I split text in a document? The 'Split' method is used to divide a text run into smaller TextRuns based on a specified delimiter, allowing for organized manipulation of text using IronWord. Can I style text in a Word document? Yes, you can style text by setting attributes such as font size, color, style (bold, italic), and effects like strikethrough, underline, superscript, and subscript using IronWord. How can images be embedded in a Word document? Images can be embedded in a Word document by loading an image from a file and adding it to a paragraph as an inline image using IronWord. What are the steps to load an image into a Word document? You can load an image from a file or a file stream into a Word document, making it possible to include visual content using IronWord. How do you configure image properties in a Word document? Image properties such as text wrapping, dimensions, position offset, and distance from corners can be configured to ensure proper display in the document using IronWord. Chaknith Bin Chat with engineering team now Software Engineer Chaknith works on IronXL and IronBarcode. He has deep expertise in C# and .NET, helping improve the software and support customers. His insights from user interactions contribute to better products, documentation, and overall experience. Ready to Get Started? Free NuGet Download View Licenses