C# Document Element Tutorial
IronWord是一個強大的Word文件程式庫，專為協助 .NET C# 開發者將建立、讀取和編輯Word和DOCX文件的功能整合到他們的應用程式中。 在Word文件的上下文中，文件元素是組成內容的基礎部分。
快速入門：建立一個樣式化的TextRun並嵌入圖片以下是您如何使用IronWord在文件中新增豐富內容–組合樣式化文字和嵌入圖片。 此範例演示了Run樣式化文字的包裝模式。
-
1Install IronWord with NuGet Package Manager
-
2複製並運行這段程式碼片段。
using IronWord; using IronWord.Models; // Create document WordDocument doc = new WordDocument(); // Create styled Run Run textRun = new Run(new TextContent("Hello IronWord!")); textRun.Style = new TextStyle() { IsBold = true, Color = Color.Blue }; // Create paragraph and add Run Paragraph paragraph = new Paragraph(); paragraph.AddChild(textRun); paragraph.AddImage(new ImageContent("pic.png")); // Add to document and save doc.AddParagraph(paragraph); doc.SaveAs("output.docx");C# -
3部署以在您的實時環境中測試
今天就開始在您的專案中使用IronWord，透過免費試用
內容目錄
- 新增文字
- 新增圖片
關鍵概念
文件層次結構
IronWord遵循結構化的文件層次結構：Document → Paragraph → Run → TextContent。 了解此層次結構對於處理樣式化文字至關重要：
WordDocument：代表整個文件的頂層容器Paragraph：文件中的內容塊TextContent的包裝物件，可以應用樣式TextContent：實際的文字字串
向段落中新增內容
IronWord提供了兩種方法來向段落中新增內容：
AddText(TextContent)：用於無樣式純文字。 直接將TextContent新增到段落中。AddChild(Run)：用於樣式化文字。 將包含Run物件新增到段落中。
當您需要應用樣式如字體大小、顏色或粗體格式時，建立一個AddChild將其新增到段落中。
新增TextRuns
文字內容
使用Split方法根據指定的分隔符將文字運行分割成較小的文字運行列表。 這樣可以在文件中組織和操作文字資訊。
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")設定樣式
設置文字樣式需要使用Run包裝模式。 建立一個包含TextContent）。 FontSize、顏色、粗體、斜體、刪除線、下劃線、上標和下標。
請注意，TextFont屬性中設置。 一旦設置了樣式，使用Run新增到段落中。 這遵循文件層次結構：Document → Paragraph → Run → TextContent。
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
FontSize = 72,
TextFont = new Font()
{
FontFamily = "Caveat"
},
Color = Color.Red,
IsBold = true,
IsItalic = true,
Underline = new Underline(),
Strike = StrikeValue.Strike,
};
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddChild(textRun);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
' Load docx
Dim doc As New WordDocument("document.docx")
' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
.FontSize = 72,
.TextFont = New Font() With {
.FontFamily = "Caveat"
},
.Color = Color.Red,
.IsBold = True,
.IsItalic = True,
.Underline = New Underline(),
.Strike = StrikeValue.Strike
}
Dim paragraph As New Paragraph()
' Add text
paragraph.AddChild(textRun)
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("save_document.docx")獲取文字填色
除了設置樣式外，IronWord還提供了一種方法讓您從現有文件中獲取RGBA顏色值，以保持整個樣式的一致性。
using IronWord;
using IronWord.Models;
using System;
// Open existing Word
WordDocument doc = new WordDocument("Accent1TextThemcolor.docx");
TextContent content = doc.Texts[0];
// This will show the R G B A of the themecolor
var filledColor = content.Color;
// Print the filled color variable to the console
Console.WriteLine(filledColor);要檢索顏色值，請使用TextContent物件。 RGBA值，允許您在整個文件中保持一致的樣式。
嵌入圖片
此功能允許您在內容中無縫地嵌入圖片，增強文件的整體視覺吸引力和傳達效果。
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(para);
// Export docx
doc.SaveAs("save_document.docx");新增圖片
載入圖片
載入圖片是一個關鍵過程。 這涉及到將外部圖像文件導入到文件中。 載入圖片的能力促進了相關視覺元素的納入，從而促成了一份更具吸引力和資訊性的文件。
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")配置圖片
通過可配置設置來優化圖片。 這包括設置屬性如文字環繞、尺寸、位置和距角落的距離。 正確的配置確保圖像以視覺上賞心悅目的方式展示，並適合上下文。
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument();
// Configure image
ImageContent image = new ImageContent("image.jpg");
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");常見問題
如何使用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文件，充分利用其全面的程式庫特性。
How do you save a Word document created with IronWord?
A Word document created with IronWord can be saved using the 'SaveAs' method, specifying the filename and path for saving the document.
What is the function of the 'AddParagraph' method in IronWord?
The 'AddParagraph' method in IronWord is used to add fully configured paragraphs, with text and images, to a Word document.
Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。
