IronWord 教程 文件元素 Document Element Tutorial Curtis Chau 更新日期:7月 30, 2025 Download IronWord NuGet 下載 Start Free Trial Copy for LLMs Copy for LLMs Copy page as Markdown for LLMs Open in ChatGPT Ask ChatGPT about this page Open in Gemini Ask Gemini about this page Open in Grok Ask Grok about this page Open in Perplexity Ask Perplexity about this page Share Share on Facebook Share on X (Twitter) Share on LinkedIn Copy URL Email article This article was translated from English: Does it need improvement? Translated View the article in English 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. Quickstart: Create a Styled TextRun and Embed an Image in One Go Here’s how you can use IronWord to add rich content fast – combining styled text and an embedded image in a single paragraph and saving the document in just one fluent code block. Perfect for developers who want to get started immediately without boilerplate. Get started making PDFs with NuGet now: Install IronWord with NuGet Package Manager PM > Install-Package IronWord Copy and run this code snippet. new WordDocument() .AddParagraph(new Paragraph(new TextContent("Hello IronWord!")).AddImage(new ImageContent("pic.png"))) .SaveAs("output.docx"); Deploy to test on your live environment Start using IronWord in your project today with a free trial Free 30 day Trial 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 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 常見問題解答 如何使用 C# 向 Word 文檔添加文本？ 您可以使用 IronWord 創建一個文本段的實例，然後將其附加到文檔內的段落中來向 Word 文檔中添加文本。 在 Word 文檔中分割文本的方法是什麼？ IronWord 提供了 Split 方法，允許您根據指定的分隔符將文本段分割為更小的部分，以便更容易進行文本操作。 如何使用 IronWord 在 Word 文檔中設置文本樣式？ 您可以通過設置各種屬性來使用 IronWord 設置文本樣式，例如字體大小，顏色和粗體、斜體、刪除線、下劃線、上標和下標等樣式。 如何使用 C# 在 Word 文檔中嵌入圖片？ 要使用 IronWord 在 Word 文檔中嵌入圖片，您可以從文件中加載圖片，並將其作為內聯圖片添加到文檔的段落中。 加載圖片到 Word 文檔的步驟有哪些？ 使用 IronWord，您可以從文件或文件流中加載圖片，這使您可以將視覺內容納入 Word 文檔中。 如何在 Word 文檔中配置圖片屬性？ 使用 IronWord，您可以配置圖片屬性，如文本環繞、尺寸、位置偏移以及與角落的距離，以確保圖片在文檔中的正確顯示。 我可以檢索 Word 文檔中文字的 RGBA 顏色值嗎？ 是的，IronWord 允許您獲得文檔中已有文本的 RGBA 顏色值，以保持一致的樣式。 如何開始使用 IronWord 來操作 Word 文檔？ 要開始使用 IronWord，您可以將其集成到您的 .NET C# 應用程序中，以創建、讀取和編輯 Word 文檔，利用其全面的庫功能。 Curtis Chau 立即與工程團隊聊天 技術作家 Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。 準備好開始了嗎？ Nuget 下載 25,807 | 版本： 2025.11 剛剛發布 免費 NuGet 下載 總下載量：25,807 查看許可證