基于 OpenXML SDK 开发的一款用于读写 Word 2007+ (.docx) 文档的 .NET 库，不依赖 Microsoft Office 应用程序 。
A .NET library for reading and writing Word 2007+ (.docx) files based on the OpenXML SDK. Does not rely on Microsoft Office applications.
下图为 Berry.Docx 支持元素的类型结构图 (The following diagram shows the type structure of the elements supported by Berry.Docx)：
Berry.Docx 的 NuGet 软件包发布在NuGet.org上:
The release NuGet packages for Berry.Docx are on NuGet.org:
| Package | Download |
|---|---|
| Berry.Docx |  |
| Berry.Docx.Visual |  |
如果你想在项目中使用 Berry.Docx，最简单的方法就是通过 NuGet 包管理器安装。
用 Visual Studio 打开自己的项目，在项目上右键选择【管理 NuGet 程序包】选项，在浏览输入框中输入“Berry.Docx”，如下所示：
If you want to include Berry.Docx in your project, you can install it directly from NuGet.
Open your project in Visual Studio, right-click the solution and select Manager NuGet Packages , then enter "Berry.Docx" in the Browse input box, as follows:
下面的示例演示如何新增一个文档并添加一个格式为“微软雅黑、小四、居中”的段落，以及一个3行3列的表格。
The following example shows how to create a new document file, and add a new paragraph with "Times New Roman font, 14 point, Center justification" format,and a 3x3 size table.
using Berry.Docx;
using Berry.Docx.Documents;
namespace Example
{
class Example
{
static void Main()
{
// 新建一个名为“example.docx”的文档 (Create a new word document called "example.docx")
using (Document doc = new Document("example.docx"))
{
// 新建一个段落 (Create a new paragraph)
Paragraph p1 = doc.CreateParagraph();
p1.Text = "这是一个段落。This is a paragraph.";
foreach(TextRange tr in p1.ChildItems.OfType<TextRange>())
{
tr.CharacterFormat.FontNameAscii = "Times New Roman";
tr.CharacterFormat.FontNameEastAsia = "微软雅黑";
tr.CharacterFormat.FontSize = 14;
}
p1.Format.Justification = JustificationType.Center;
// 新建一个表格 (Create a new table)
Table tbl1 = doc.CreateTable(3, 3);
tbl1.Rows[0].Cells[1].Paragraphs[0].Text = "1st Column";
tbl1.Rows[0].Cells[2].Paragraphs[0].Text = "2nd Column";
tbl1.Rows[1].Cells[0].Paragraphs[0].Text = "1st Row";
tbl1.Rows[2].Cells[0].Paragraphs[0].Text = "2nd Row";
// 添加到文档中 (Add to the document)
doc.Sections[0].ChildObjects.Add(p1);
doc.Sections[0].ChildObjects.Add(tbl1);
// 保存 (Save)
doc.Save();
}
}
}
}| Features |
|---|
| 操作段落和字符|Manipulates paragraphs and characters |
| 操作表格及其行和单元格|Manipulates table and it's rows and cells |
| 读写字符格式(中文字体，西文字体，字号，加粗，斜体等)|Read-write character format (FontNameEastAsia, FontNameAscii, FontSize, Bold, Italic etc.) |
| 读写段落格式(对齐方式, 大纲级别, 缩进, 间距等.)|Read-write paragraph format (Justification, OutlineLevel, Indentation, Spacing etc.) |
| 读写段落、表格、字符样式|Read-write paragraph, table, character style |
| 插入分节符，分页符和手动换行符|Inserts section break，page break and line break |
| 添加批注|Appends comments |
| 操作页眉页脚|Manipulates header and footers |
| 读写页面设置|Read-write page setup |
| 读写列表样式|Read-write list style |
| 查找文本|Find text |
| 读写表格格式 | Read-write table formats |
| 向段落中添加图片、分隔符和制表位 | Append picture , break and tab to paragraph |
| 读写域代码 | Read-write field codes |
| 添加书签、超链接和目录 | Adds bookmark、hyperlink and TOC |
- 支持读写表格边框和底纹格式 (Supports read-write table borders and background color)。
-
支持读取段落中的字符的最终格式 (Supports reading the final format of characters of the paragraph)；
-
新增了 Berry.Docx.Visual 项目，用于构建文档在显示时的组成结构 (Added Berry.Docx.Visua project, Used to build the structure of the document when display)。
-
新增了对 .NET Framework 3.5 的支持 (Supports .NET Framework 3.5)；
-
修复了一些问题 (Fixed some bugs)。
-
支持书签 (Supports bookmark)；
-
支持超链接 (Supports hyperlink)；
-
支持添加目录 (Supports add toc)。
-
支持读写域代码 (Support read-write field codes)；
-
修复了一些问题 (Fixed some bugs)。
-
支持向段落中添加图片、分隔符和制表位 (Support append picture , break and tab to paragraph)；
-
支持更多的格式 (Support more formats)；
-
修复了在解析无效超链接时抛出异常的问题 (Fixed an exception being thrown when parsing malformed hyperlinks)。
- 支持读写表格格式 (Support read-write table formats)。
- 修复
TextMatch.GetAsOneRange()方法抛出异常的问题 (Fixed the bug thatTextMatch.GetAsOneRange()throw an exception)。
- 支持更多字符和段落格式 (Support more character and paragraph format)；
- 支持读写页面设置 (Support read-write page setup)；
- 支持读写段落、字符和表格样式(Support read-write paragraph, table and character style)；
- 支持读写列表样式 (Support read-write list style)；
- 支持查找文本 (Support find text)。
- 支持操作页眉和页脚 （Supports manipulating headers and footers)。
- 支持更多字符和段落高级格式 (Supports more character and paragraph advanced formats)；
- 支持插入分节符 (Supports insert section break)；
- 支持插入批注 (Supports append paragraph comments)。
-
支持新增/删除段落 (Supports add/remove paragraphs)；
-
支持新增/删除表格，以及在表格中插入行，列，单元格和段落 (Supports add/remove tables, and add/insert rows, columns, cells, paragraphs to the table)。
- 支持创建、打开 DOCX 文档 (Supports create & open DOCX files)；
- 支持读取、设置段落的常规格式 (字体、对齐方式、缩进、间距) (Supports read and change the normal format (Font、Justification、Indentation、Spacing) of paragraph)。
- 支持更多图形属性 (Support more shape properties)