<think>我们根据引用内容，用户想了解如何使用DocumentFormat.OpenXml将实体类对象写入Excel。 引用[1]和[2]介绍了DocumentFormat.OpenXml的基本用法，包括创建Excel文档、工作簿和工作表。 引用[3]展示了一个示例，其中调用了ExcelWrite.WriteObj方法将对象列表写入Excel，但具体实现没有给出。 因此，我们需要自己实现一个将实体类对象列表写入Excel的方法。步骤如下： 1. 创建一个Excel文件（可以基于模板，也可以全新创建）。 2. 打开或创建SpreadsheetDocument。 3. 获取或创建WorkbookPart和WorksheetPart。 4. 创建SheetData，并生成行和单元格，将对象属性值填入单元格。 5. 保存并关闭文档。 由于引用[3]中使用了模板，我们可以先考虑从模板复制文件，然后打开并写入数据。 实现思路： - 假设我们有一个实体类T的列表List<T> data。 - 我们需要将每个对象的属性写入到工作表的行中，第一行可以写标题（属性名称）。 - 写入数据时，需要将数据转换为合适的Excel单元格类型（文本、数字等）。 下面我们将编写一个通用的写入方法，但请注意，为了简化，我们假设所有属性都直接写入，且按照属性顺序写入列。 步骤： 1. 复制模板文件到目标文件（如果使用模板）。 2. 打开目标文件的SpreadsheetDocument。 3. 获取第一个工作表（或指定名称的工作表）的SheetData。 4. 写入标题行（使用属性名）。 5. 遍历数据列表，为每个对象创建一行，并将属性值写入单元格。 6. 保存并关闭文档。 注意：OpenXML的行和单元格索引从1开始，但我们在代码中创建行和单元格时，行号从1开始（第一行是标题），列用字母表示（如A、B、C）或使用索引转换。 但是，OpenXML SDK要求我们使用Cell类来创建单元格，并且需要设置数据类型和值。 由于我们不知道具体实体类的属性，所以使用反射来获取属性列表。 下面是一个示例代码： 注意：此代码需要添加必要的错误处理和资源释放。 </think> 在 C# 中使用 `DocumentFormat.OpenXml` 将实体类对象写入 Excel 的实现方法如下，该方法利用反射动态获取实体属性，并支持基于模板文件写入数据： ### 实现步骤 #### 1. 准备 Excel 模板文件 创建包含表头的基础模板（如 `模板.xlsx`），确定数据起始行位置（例如第 3 行开始写入数据）。 #### 2. 核心写入方法 ```csharp using DocumentFormat.OpenXml; using DocumentFormat.OpenXml.Packaging; using DocumentFormat.OpenXml.Spreadsheet; using System.Reflection; public static void WriteObjectsToExcel<T>(string filePath, List<T> data, int startRowIndex) { // 复制模板文件 string tempPath = Path.GetTempFileName(); File.Copy(filePath, tempPath, true); // 打开文档并写入数据 using (SpreadsheetDocument document = SpreadsheetDocument.Open(tempPath, true)) { WorkbookPart workbookPart = document.WorkbookPart; WorksheetPart worksheetPart = workbookPart.WorksheetParts.First(); SheetData sheetData = worksheetPart.Worksheet.GetFirstChild<SheetData>(); // 获取属性列表 PropertyInfo[] properties = typeof(T).GetProperties(); // 写入数据行 for (int i = 0; i < data.Count; i++) { Row row = new Row() { RowIndex = (uint)(startRowIndex + i) }; T item = data[i]; for (int col = 0; col < properties.Length; col++) { object value = properties[col].GetValue(item); Cell cell = new Cell() { CellReference = $"{GetColumnName(col + 1)}{startRowIndex + i}", DataType = CellValues.String, CellValue = new CellValue(value?.ToString() ?? "") }; row.AppendChild(cell); } sheetData.AppendChild(row); } worksheetPart.Worksheet.Save(); } // 替换原文件 File.Delete(filePath); File.Move(tempPath, filePath); } // 辅助方法：列索引转字母（如 1->A, 2->B） private static string GetColumnName(int columnIndex) { string columnName = ""; while (columnIndex > 0) { int remainder = (columnIndex - 1) % 26; columnName = Convert.ToChar('A' + remainder) + columnName; columnIndex = (columnIndex - 1) / 26; } return columnName; } ``` #### 3. 调用示例 ```csharp // 实体类定义 public class Student { public string Name { get; set; } public int Age { get; set; } public DateTime EnrollmentDate { get; set; } } // 写入数据 List<Student> students = new List<Student> { new Student { Name = "张三", Age = 20, EnrollmentDate = new DateTime(2023, 9, 1) }, new Student { Name = "李四", Age = 22, EnrollmentDate = new DateTime(2023, 9, 5) } }; WriteObjectsToExcel("学生数据.xlsx", students, startRowIndex: 3); // 从第3行开始写入 ``` ### 关键点说明 1. **模板利用** 通过复制模板文件保留原有格式（样式、公式等），避免重复创建基础结构[^3]。 2. **动态列映射** 反射自动获取实体类属性，无需硬编码列名，支持灵活扩展[^1]。 3. **数据类型处理** - 所有数据转为字符串写入（`CellValues.String`） - 实际应用中可按需扩展类型判断： ```csharp if (property.PropertyType == typeof(DateTime)) { cell.DataType = CellValues.Date; cell.CellValue = new CellValue(((DateTime)value).ToOADate().ToString()); } ``` 4. **性能优化** - 使用临时文件操作保证写入失败时原文件不受损 - 批量写入减少文件操作次数 ### 常见问题解决 - **格式丢失问题**：确保模板文件包含完整的 `StylesPart`，写入时不要覆盖样式定义。 - **大数据量优化**：超过 10000 行时建议使用 `OpenXmlWriter` 流式写入。 - **特殊字符处理**：对 XML 特殊字符（如 `<`, `>`）使用 `SecurityElement.Escape()` 转义。 > 此实现基于 OpenXML 标准，生成的 .xlsx 文件兼容 Excel 2007+ 和 WPS 等办公软件[^2]。