微軟從 Office 2007 開始，將 Open XML 檔案格式改成 Office 預設的檔案格式。 而 Open XML SDK 是微軟提供一套API, 讓開發人員可以在不需要安裝 Microsoft Office 的情況下，直接讀取和寫入 Office 文件。
前置作業
先安裝 NuGet 套件：
dotnet add package DocumentFormat.OpenXml
範例程式碼
[Test]
public void Sample()
{
string output = @"D:\\Sample.docx";
using (WordprocessingDocument wordDoc = WordprocessingDocument.Create(output, WordprocessingDocumentType.Document))
{
var doc = new Document();
var body = new Body();
// 加入主要文件部件
MainDocumentPart mainPart = wordDoc.AddMainDocumentPart();
mainPart.Document = doc;
//==========================================
// 加入樣式定義部件
//==========================================
StyleDefinitionsPart stylePart = mainPart.AddNewPart<StyleDefinitionsPart>();
AddHeading1Style(stylePart);
//==========================================
// 設定紙張為橫式 & 邊界為窄邊界
//==========================================
SectionProperties sectionProps = new SectionProperties();
//設定頁面大小
PageSize pageSize = new()
{
Width = 16838U, // A4 橫向
Height = 11906U,
Orient = PageOrientationValues.Landscape
};
//設定頁邊距(窄邊界) 1 英寸 = 1440 Twips
PageMargin pageMargin = new()
{
Top = 720, // 上邊界：0.5 inch
Right = 720, // 右邊界：0.5 inch
Bottom = 720, // 下邊界：0.5 inch
Left = 720, // 左邊界：0.5 inch
Header = 720, // 頁首距離：0.5 inch
Footer = 720, // 頁尾距離：0.5 inch
Gutter = 0 // 裝訂線：0
};
sectionProps.Append(pageSize, pageMargin);
body.Append(sectionProps);
//==========================================
// 建立一個標題
//==========================================
Paragraph headingParagraph = new Paragraph();
// 段落屬性，設定為標題 1
ParagraphProperties paragraphProperties = new ParagraphProperties();
paragraphProperties.ParagraphStyleId = new ParagraphStyleId() { Val = "Heading1" };
headingParagraph.Append(paragraphProperties);
// 加入文字
Run run = new Run();
run.Append(new Text("這是標題"));
headingParagraph.Append(run);
// 插入到文件中
body.Append(headingParagraph);
//==========================================
// 插入一個段落
//==========================================
var normalParagraph = new Paragraph(new Run(new Text("這是一個文字段落")));
body.Append(normalParagraph);
//==========================================
// 建立一個表格
//==========================================
Table table = new();
// 設定表格樣式
TableProperties tableProperties = new TableProperties();
TableBorders borders = new TableBorders
{
TopBorder = new TopBorder { Val = BorderValues.Single }, // 上邊框
BottomBorder = new BottomBorder { Val = BorderValues.Single }, // 下邊框
LeftBorder = new LeftBorder { Val = BorderValues.Single }, // 左邊框
RightBorder = new RightBorder { Val = BorderValues.Single }, // 右邊框
InsideHorizontalBorder = new InsideHorizontalBorder { Val = BorderValues.Single }, // 內部水平邊框
InsideVerticalBorder = new InsideVerticalBorder { Val = BorderValues.Single }, // 內部垂直邊框
};
TableWidth tableWidth = new() { Width = "5000", Type = TableWidthUnitValues.Pct };
TableStyle tableStyle = new() { Val = "TableGrid" };
tableProperties.Append(borders, tableWidth, tableStyle);
table.AppendChild(tableProperties);
// 建立表格標題列
string[] captions = ["欄位一", "欄位二", "欄位三"];
var th = new TableRow();
foreach (var caption in captions)
{
var tc = new TableCell();
// 定義一個段落
Paragraph cellParagraph = new();
// 設定段落與前後段的間距 spacing
ParagraphProperties cellParagraphProperties = new();
SpacingBetweenLines cellSpacing = new()
{
BeforeAutoSpacing = true, // 與前段間距:自動
AfterAutoSpacing = true, // 與後段間距:自動
LineRule = LineSpacingRuleValues.Auto
};
cellParagraphProperties.AppendChild(cellSpacing);
cellParagraph.AppendChild(cellParagraphProperties);
cellParagraph.AppendChild(new Run(new Text(caption)));
// 設定儲存格屬性 - 背景顏色
var cellProperty = new TableCellProperties();
var shading = new Shading()
{
Color = "auto", // 文字颜色
Fill = "cfe2f3", // 背景颜色
Val = ShadingPatternValues.Clear
};
cellProperty.Append(shading);
tc.Append(cellParagraph, cellProperty);
th.Append(tc);
}
table.AppendChild(th);
// 建立表格資料列
for (int i = 0; i < 3; i++)
{
TableRow tr = new TableRow();
tr.Append(
CreateCell($"欄一 {i + 1}"),
CreateCell($"欄二 {i + 1}"),
CreateCell($"欄三 {i + 1}")
);
table.Append(tr);
}
body.AppendChild(table);
doc.AppendChild(body);
mainPart.Document.Save();
}
}
// 建立一般儲存格的輔助方法
private TableCell CreateCell(string text)
{
return new TableCell(
new TableCellProperties(
new TableCellWidth() { Type = TableWidthUnitValues.Dxa, Width = "2400" }
),
new Paragraph(new Run(new Text(text)))
);
}
/// <summary>
/// 新增 Heading1 樣式到樣式定義部件
/// </summary>
/// <param name="stylePart"></param>
private static void AddHeading1Style(StyleDefinitionsPart stylePart)
{
stylePart.Styles ??= new Styles();
Styles styles = stylePart.Styles;
// 檢查是否已存在 Heading1 樣式
if (styles.Elements<Style>().Any(s => s.StyleId == "Heading1"))
return;
// 建立新的樣式
Style style = new Style()
{
Type = StyleValues.Paragraph,
StyleId = "Heading1",
CustomStyle = true
};
// 樣式名稱（可顯示在 UI 中）
style.Append(new StyleName() { Val = "Heading 1" });
// UI 顯示樣式名稱
style.Append(new BasedOn() { Val = "Normal" });
style.Append(new NextParagraphStyle() { Val = "Normal" });
// 加入樣式類型標記（Heading）
style.Append(new StyleParagraphProperties(
new KeepNext(),
new KeepLines(),
new SpacingBetweenLines() { Before = "240", After = "60" },
new OutlineLevel() { Val = 0 })
);
style.Append(new StyleRunProperties(
new Bold(),
new Color() { Val = "2E74B5" }, // 深藍色
new FontSize() { Val = "32" }, // 16 pt（乘2）
new RunFonts() { Ascii = "Calibri", HighAnsi = "Calibri" }
));
styles.Append(style);
styles.Save();
}
