Berry.Docx

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 17 Open GitHub ↗

基于 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.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Berry.Docx

[![Downloads](https://img.shields.io/nuget/dt/Berry.Docx.svg)](https://www.nuget.org/packages/Berry.Docx)

基于 [OpenXML SDK](https://github.com/dotnet/Open-XML-SDK) 开发的一款用于读写 Word 2007+ (.docx) 文档的 .NET 库，不依赖 Microsoft Office 应用程序 。

A .NET library for reading and writing Word 2007+ (.docx) files based on the [OpenXML SDK](https://github.com/dotnet/Open-XML-SDK). Does not rely on Microsoft Office applications.

下图为 Berry.Docx 支持元素的类型结构图 (The following diagram shows the type structure of the elements supported by Berry.Docx)：

![](https://raw.githubusercontent.com/theyangfan/Berry.Docx/main/images/elements_type_structure.png)

# 程序包（Packages）

Berry.Docx 的 NuGet 软件包发布在NuGet.org上:

*The release NuGet packages for Berry.Docx are on NuGet.org:*

| Package           | Download                                                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------------------ |
| Berry.Docx        | [![NuGet](https://img.shields.io/nuget/v/Berry.Docx.svg)](https://www.nuget.org/packages/Berry.Docx)               |
| Berry.Docx.Visual | [![NuGet](https://img.shields.io/nuget/v/Berry.Docx.Visual.svg)](https://www.nuget.org/packages/Berry.Docx.Visual) |

## 通过 NuGet 安装（Install via NuGet）

如果你想在项目中使用 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:*

![image](https://raw.githubusercontent.com/theyangfan/Berry.Docx/main/images/nuget_package_manager.png)

# 示例（Examples）

下面的示例演示如何新增一个文档并添加一个格式为“微软雅黑、小四、居中”的段落，以及一个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.*

```c#
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();
 }
 }
 }
}
```

# 主要功能（Main Features）

| 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                                                                            |

# 文档（Documentation）

- [使用指南 (Usage Guide)](https://github.com/theyangfan/Berry.Docx/wiki)

- [API 文档 (API Documentation)](https://theyangfan.github.io/Berry.Docx)

# 更新日志（Release History）

### v1.3.7 (2023-06-16)

- 支持读写表格边框和底纹格式 (Supports read-write table borders and background color)。

### v1.3.6 (2023-05-29)

- 支持读取段落中的字符的最终格式 (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)。

### v1.3.5 (2023-05-12)

- 支持书签 (Supports bookmark)；

- 支持超链接 (Supports hyperlink)；

- 支持添加目录 (Supports add toc)。

### v1.3.4 (2023-04-13)

- 支持读写域代码 (Support read-write field codes)；

- 修复了一些问题 (Fixed some bugs)。

### v1.3.3 (2023-03-22)

- 支持向段落中添加图片、分隔符和制表位 (*Support append picture , break and tab to paragraph*)；

- 支持更多的格式 (*Support more formats*)；

- 修复了在解析无效超链接时抛出异常的问题 (*Fixed an exception being thrown when parsing malformed hyperlinks*)。

### v1.3.2 (2022-08-26)

- 支持读写表格格式 (*Support read-write table formats*)。

### v1.3.1 (2022-08-02)

- 修复 `TextMatch.GetAsOneRange()` 方法抛出异常的问题 (Fixed the bug that  `TextMatch.GetAsOneRange()` throw an exception)。

### v1.3.0 (2022-08-01)

- 支持更多字符和段落格式 (*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*)。

### v1.2.0 (2022-03-22)

- 支持操作页眉和页脚 （*Supports manipulating headers and footers*)。

### v1.1.0 (2022-03-06)

- 支持更多字符和段落高级格式 (*Supports more character and paragraph advanced formats*)；
- 支持插入分节符 (*Supports insert section break*)；
- 支持插入批注 (*Supports append paragraph comments*)。

### v1.0.1 (2022-02-11)

- 支持新增/删除段落 (*Supports add/remove paragraphs*)；

- 支持新增/删除表格，以及在表格中插入行，列，单元格和段落 (*Supports add/remove tables, and add/insert rows, columns, cells, paragraphs to the table*)。

### v1.0.0（2022-01-03）

- 支持创建、打开 DOCX 文档 (*Supports create & open DOCX files*)；
- 支持读取、设置段落的常规格式 (字体、对齐方式、缩进、间距) (*Supports read and change the normal format (Font、Justification、Indentation、Spacing) of paragraph*)。

# 下版本计划（Next Version Plan）

- 支持更多图形属性 (*Support more shape properties*)

Berry.Docx

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README