### 关于 `DocumentFormat.OpenXml` 的使用教程 #### 1. 基本概念 `DocumentFormat.OpenXml` 是 Microsoft 提供的一个用于操作 Open XML 文档的库。通过该库，开发人员可以在不依赖 Office 安装的情况下读取、修改和创建 Word、Excel 和 PowerPoint 文件。 核心组件包括但不限于以下模块[^1]: - **DocumentFormat.OpenXml**: 表示 Open XML 文档的不同部分，如文档、段落、表格等。 - **DocumentFormat.OpenXml.Packaging**: 提供 API 来打包和解包文档内容。 - **DocumentFormat.OpenXml.Spreadsheet**: 主要针对 Excel 文档的操作，提供工作簿、工作表等相关类的支持。 --- #### 2. 示例代码：创建简单的 Excel 工作簿 以下是使用 `DocumentFormat.OpenXml` 创建一个简单 Excel 文件的示例： ```csharp using System; using DocumentFormat.OpenXml; using DocumentFormat.OpenXml.Packaging; using DocumentFormat.OpenXml.Spreadsheet; class Program { static void Main(string[] args) { string filePath = "example.xlsx"; using (SpreadsheetDocument spreadsheetDoc = SpreadsheetDocument.Create(filePath, SpreadsheetDocumentType.Workbook)) { WorkbookPart workbookPart = spreadsheetDoc.AddWorkbookPart(); workbookPart.Workbook = new Workbook(); WorksheetPart worksheetPart = workbookPart.AddNewPart<WorksheetPart>(); worksheetPart.Worksheet = new Worksheet(new SheetData()); Sheets sheets = spreadsheetDoc.WorkbookPart.Workbook.AppendChild(new Sheets()); Sheet sheet = new Sheet() { Id = spreadsheetDoc.WorkbookPart.GetIdOfPart(worksheetPart), SheetId = 1, Name = "Sheet1" }; sheets.Append(sheet); // 添加数据到单元格 A1 Cell cellA1 = InsertCellInWorksheet("A", 1, worksheetPart); SetValueToCell(cellA1, "Hello"); // 添加数据到单元格 B1 Cell cellB1 = InsertCellInWorksheet("B", 1, worksheetPart); SetValueToCell(cellB1, "World"); } Console.WriteLine($"文件已保存至: {filePath}"); } private static Cell InsertCellInWorksheet(string columnName, uint rowIndex, WorksheetPart worksheetPart) { Worksheet worksheet = worksheetPart.Worksheet; SheetData sheetData = worksheet.GetFirstChild<SheetData>(); Row row = GetRow(sheetData, rowIndex); Cell refCell = null; foreach (var cell in row.Elements<Cell>()) { if (string.Compare(columnName, cell.CellReference.Value, true) > 0) refCell = cell; } Cell insertCell = new Cell() { DataType = CellValues.String, CellValue = new CellValue(), CellReference = $"{columnName}{rowIndex}" }; row.InsertAfter(insertCell, refCell); return insertCell; } private static Row GetRow(SheetData sheetData, uint rowIndex) { var row = sheetData.Elements<Row>().FirstOrDefault(r => r.RowIndex == rowIndex); if (row == null) { row = new Row() { RowIndex = rowIndex }; sheetData.Append(row); } return row; } private static void SetValueToCell(Cell cell, string value) { cell.CellValue.Text = value; } } ``` 此代码展示了如何创建一个新的 Excel 文件并写入一些基本的数据。具体功能包括： - 创建新的工作簿和工作表。 - 向指定单元格插入字符串值。 - 自动调整行列索引以确保数据正确存储。 --- #### 3. 示例代码：读取现有的 Excel 文件 如果需要读取现有 Excel 文件中的数据，可以参考以下代码片段： ```csharp using System; using DocumentFormat.OpenXml.Packaging; using DocumentFormat.OpenXml.Spreadsheet; class Program { static void Main(string[] args) { string filePath = "existingFile.xlsx"; using (SpreadsheetDocument document = SpreadsheetDocument.Open(filePath, false)) { WorkbookPart workbookPart = document.WorkbookPart; Sheet theSheet = workbookPart.Workbook.Descendants<Sheet>().FirstOrDefault(s => s.Name == "Sheet1"); if (theSheet != null) { WorksheetPart worksheetPart = (WorksheetPart)(workbookPart.GetPartById(theSheet.Id)); SheetData sheetData = worksheetPart.Worksheet.Elements<SheetData>().First(); foreach (Row r in sheetData.Elements<Row>()) { foreach (Cell c in r.Elements<Cell>()) { string text = GetValue(c, workbookPart); Console.Write(text + "\t"); } Console.WriteLine(); } } } } public static string GetValue(Cell cell, WorkbookPart workbookPart) { string value = cell.CellValue?.InnerText ?? ""; if (cell.DataType != null && cell.DataType == CellValues.SharedString) { SharedStringTable sharedStringTable = workbookPart.SharedStringTablePart.SharedStringTable; int index = int.Parse(value); value = sharedStringTable.ChildElements[index].InnerText; } return value; } } ``` 这段代码实现了从已有 Excel 文件中提取数据的功能，并打印每行的内容。 --- #### 4. 参考资源 除了上述代码外，还可以参考微软官方文档获取更多细节[^2]。此外，虽然可以通过其他工具（如 COM 组件）实现类似的文档生成需求，但 `DocumentFormat.OpenXml` 更适合跨平台环境下的无状态操作[^3]。 ---