.NET驾驭Word之力：数据驱动文档 - 邮件合并与自定义数据填充完全指南

你是否曾经需要为数百名员工生成个性化的工资条？你是否希望根据客户信息批量生成合同文档？你是否想要根据数据库中的数据自动生成各类报告？通过本文介绍的邮件合并和自定义数据填充技术，你将能够轻松实现这些功能，大大提高文档处理的效率和准确性。

在实际的企业应用场景中，基于.net平台的 Word 自动化处理技术可以实现：

• 人力资源管理：批量生成工资条、入职通知书、绩效评估报告等
  
• 销售与客户管理：批量生成客户合同、报价单、服务协议等
  
• 财务管理：批量生成发票、对账单、财务报告等
  
• 行政办公：批量生成各类通知、证书、证明文件等
  
• 教育培训：批量生成成绩单、结业证书、培训记录等
  
• 法律服务：批量生成法律文书、合同模板、案件报告等
  

本文将详细介绍如何使用MudTools.OfficeInterop.Word 库来实现传统的邮件合并功能和更灵活的自定义数据填充方案。如何从数据库（SQL Server）、Excel、JSON文件等数据源读取数据，并使用循环和上文技术（书签、查找替换、表格操作）将数据批量填充到Word文档的指定位置。最后，将通过一个实战示例，创建一个批量员工工资条生成系统，真正掌握Word数据交互的精髓。
使用传统的邮件合并功能

邮件合并是Word中最经典的数据交互功能之一，它允许我们将外部数据源（如Excel表格、Access数据库等）与Word文档模板结合，批量生成个性化的文档。
传统的邮件合并功能虽然强大，但在现代应用开发中，我们往往需要更灵活的控制方式。不过，了解邮件合并的基本原理仍然很有价值，因为它为我们理解数据驱动文档的核心概念提供了基础。
传统的邮件合并过程通常包括以下步骤：

• 创建包含合并域的主文档（模板）
  
• 准备数据源（如Excel文件或数据库）
  
• 在Word中配置邮件合并向导
  
• 预览并完成合并
  

虽然MudTools.OfficeInterop.Word库目前没有直接提供邮件合并功能，但我们可以通过自定义数据填充的方式实现更强大、更灵活的功能。
实际业务场景：传统邮件合并的局限性

在许多企业环境中，传统的邮件合并功能虽然能满足基本需求，但在面对复杂业务场景时往往显得力不从心。
场景一：多数据源整合
某大型制造企业需要为供应商生成年度评估报告。这些报告需要整合来自多个系统的数据：

• ERP系统（供应商基本信息、交易记录）
  
• 质量管理系统（质量检测数据）
  
• 财务系统（付款记录、信用评级）
  

传统的邮件合并只能处理单一数据源，无法满足这种多源数据整合的需求。
场景二：动态格式要求
某金融机构需要为客户生成个性化的投资报告。不同类型的客户（个人客户、企业客户、VIP客户）需要不同的报告格式和内容结构。传统的邮件合并只能生成格式固定的文档，无法根据客户类型动态调整文档结构。
场景三：复杂的业务逻辑
某咨询公司需要为不同行业的客户生成市场分析报告。报告内容需要根据客户的行业特点、规模、地理位置等信息应用不同的分析模型和展示方式。传统的邮件合并缺乏处理复杂业务逻辑的能力。
通过自定义数据填充方案，我们可以突破这些限制，实现更智能、更灵活的文档生成系统。
更灵活的方案：自定义数据填充

自定义数据填充是一种比传统邮件合并更灵活、更可控的数据交互方案。通过这种方式，我们可以从各种数据源读取数据，并精确控制数据在文档中的填充位置和格式。
从数据库（SQL Server）、Excel、JSON文件等数据源读取数据

在实际应用中，数据可能来自各种不同的源，包括关系型数据库、Excel文件、JSON数据等。我们需要能够灵活地处理这些不同的数据源。

1. using MudTools.OfficeInterop;
2. using MudTools.OfficeInterop.Word;
3. using System;
4. using System.Collections.Generic;
5. using System.Data;
6. using System.Data.SqlClient;
7. using System.IO;
8. using Newtonsoft.Json;
10. // 数据模型
11. public class Employee
12. {
13.     public int Id { get; set; }
14.     public string Name { get; set; }
15.     public string Department { get; set; }
16.     public decimal Salary { get; set; }
17.     public decimal Bonus { get; set; }
18.     public DateTime HireDate { get; set; }
19. }
21. // 数据访问服务
22. public class DataService
23. {
24.     /// <summary>
25.     /// 从SQL Server数据库读取员工数据
26.     /// </summary>
27.     /// <param name="connectionString">数据库连接字符串</param>
28.     /// <returns>员工数据列表</returns>
29.     public List<Employee> GetEmployeesFromDatabase(string connectionString)
30.     {
31.         var employees = new List<Employee>();
32.         
33.         try
34.         {
35.             using (var connection = new SqlConnection(connectionString))
36.             {
37.                 connection.Open();
38.                 var command = new SqlCommand("SELECT Id, Name, Department, Salary, Bonus, HireDate FROM Employees", connection);
39.                 using (var reader = command.ExecuteReader())
40.                 {
41.                     while (reader.Read())
42.                     {
43.                         employees.Add(new Employee
44.                         {
45.                             Id = reader.GetInt32("Id"),
46.                             Name = reader.GetString("Name"),
47.                             Department = reader.GetString("Department"),
48.                             Salary = reader.GetDecimal("Salary"),
49.                             Bonus = reader.GetDecimal("Bonus"),
50.                             HireDate = reader.GetDateTime("HireDate")
51.                         });
52.                     }
53.                 }
54.             }
55.         }
56.         catch (Exception ex)
57.         {
58.             Console.WriteLine($"从数据库读取员工数据时发生错误: {ex.Message}");
59.         }
60.         
61.         return employees;
62.     }
63.    
64.     /// <summary>
65.     /// 从Excel文件读取员工数据
66.     /// </summary>
67.     /// <param name="excelFilePath">Excel文件路径</param>
68.     /// <returns>员工数据列表</returns>
69.     public List<Employee> GetEmployeesFromExcel(string excelFilePath)
70.     {
71.         var employees = new List<Employee>();
72.         
73.         try
74.         {
75.             // 这里应该使用适当的Excel读取库，如EPPlus或NPOI
76.             // 为简化示例，我们直接返回模拟数据
77.             employees.Add(new Employee
78.             {
79.                 Id = 1,
80.                 Name = "张三",
81.                 Department = "技术部",
82.                 Salary = 15000,
83.                 Bonus = 3000,
84.                 HireDate = new DateTime(2020, 1, 15)
85.             });
86.             
87.             employees.Add(new Employee
88.             {
89.                 Id = 2,
90.                 Name = "李四",
91.                 Department = "销售部",
92.                 Salary = 12000,
93.                 Bonus = 5000,
94.                 HireDate = new DateTime(2019, 3, 22)
95.             });
96.         }
97.         catch (Exception ex)
98.         {
99.             Console.WriteLine($"从Excel文件读取员工数据时发生错误: {ex.Message}");
100.         }
101.         
102.         return employees;
103.     }
104.    
105.     /// <summary>
106.     /// 从JSON文件读取员工数据
107.     /// </summary>
108.     /// <param name="jsonFilePath">JSON文件路径</param>
109.     /// <returns>员工数据列表</returns>
110.     public List<Employee> GetEmployeesFromJson(string jsonFilePath)
111.     {
112.         var employees = new List<Employee>();
113.         
114.         try
115.         {
116.             if (File.Exists(jsonFilePath))
117.             {
118.                 var jsonContent = File.ReadAllText(jsonFilePath);
119.                 employees = JsonConvert.DeserializeObject<List<Employee>>(jsonContent);
120.             }
121.         }
122.         catch (Exception ex)
123.         {
124.             Console.WriteLine($"从JSON文件读取员工数据时发生错误: {ex.Message}");
125.         }
126.         
127.         return employees;
128.     }
129. }

复制代码

应用场景：多数据源集成处理与复杂业务逻辑实现

在现代企业运营中，数据孤岛现象普遍存在，关键信息分散在HR系统、财务系统、CRM系统、ERP系统等多个独立平台中。传统的邮件合并功能只能处理单一数据源，而自定义数据填充方案则能够打破这些壁垒，实现跨系统的数据整合与智能处理。

1. using MudTools.OfficeInterop;
2. using MudTools.OfficeInterop.Word;
3. using System;
4. using System.Collections.Generic;
6. // 综合数据服务
7. public class ComprehensiveDataService
8. {
9.     private readonly DataService _dataService;
10.    
11.     public ComprehensiveDataService()
12.     {
13.         _dataService = new DataService();
14.     }
15.    
16.     /// <summary>
17.     /// 获取综合员工数据
18.     /// </summary>
19.     /// <returns>综合员工数据列表</returns>
20.     public List<ComprehensiveEmployeeData> GetComprehensiveEmployeeData()
21.     {
22.         var comprehensiveDataList = new List<ComprehensiveEmployeeData>();
23.         
24.         try
25.         {
26.             // 从不同数据源获取数据
27.             var hrEmployees = _dataService.GetEmployeesFromDatabase("HR数据库连接字符串");
28.             // var financeData = _dataService.GetEmployeesFromExcel("财务数据Excel路径");
29.             // var projectData = _dataService.GetEmployeesFromJson("项目数据JSON路径");
30.             
31.             // 整合数据
32.             foreach (var employee in hrEmployees)
33.             {
34.                 var comprehensiveData = new ComprehensiveEmployeeData
35.                 {
36.                     Id = employee.Id,
37.                     Name = employee.Name,
38.                     Department = employee.Department,
39.                     Salary = employee.Salary,
40.                     Bonus = employee.Bonus,
41.                     HireDate = employee.HireDate,
42.                     // 这里可以添加从其他数据源获取的信息
43.                     PerformanceRating = CalculatePerformanceRating(employee),
44.                     ProjectsCompleted = GetProjectsCompleted(employee.Id)
45.                 };
46.                
47.                 comprehensiveDataList.Add(comprehensiveData);
48.             }
49.         }
50.         catch (Exception ex)
51.         {
52.             Console.WriteLine($"获取综合员工数据时发生错误: {ex.Message}");
53.         }
54.         
55.         return comprehensiveDataList;
56.     }
57.    
58.     /// <summary>
59.     /// 计算绩效评级
60.     /// </summary>
61.     /// <param name="employee">员工信息</param>
62.     /// <returns>绩效评级</returns>
63.     private string CalculatePerformanceRating(Employee employee)
64.     {
65.         // 简化的绩效评级计算逻辑
66.         if (employee.Salary > 15000)
67.             return "优秀";
68.         else if (employee.Salary > 10000)
69.             return "良好";
70.         else
71.             return "合格";
72.     }
73.    
74.     /// <summary>
75.     /// 获取完成的项目数量
76.     /// </summary>
77.     /// <param name="employeeId">员工ID</param>
78.     /// <returns>完成的项目数量</returns>
79.     private int GetProjectsCompleted(int employeeId)
80.     {
81.         // 模拟数据
82.         return employeeId switch
83.         {
84.             1 => 5,
85.             2 => 3,
86.             _ => 0
87.         };
88.     }
89. }
91. /// <summary>
92. /// 综合员工数据模型
93. /// </summary>
94. public class ComprehensiveEmployeeData
95. {
96.     public int Id { get; set; }
97.     public string Name { get; set; }
98.     public string Department { get; set; }
99.     public decimal Salary { get; set; }
100.     public decimal Bonus { get; set; }
101.     public DateTime HireDate { get; set; }
102.     public string PerformanceRating { get; set; }
103.     public int ProjectsCompleted { get; set; }
104.    
105.     /// <summary>
106.     /// 获取总收入（薪资+奖金）
107.     /// </summary>
108.     public decimal TotalIncome => Salary + Bonus;
109.    
110.     /// <summary>
111.     /// 获取工作年限
112.     /// </summary>
113.     public int YearsOfService => DateTime.Now.Year - HireDate.Year;
114. }

复制代码

使用循环和上文技术（书签、查找替换、表格操作）将数据批量填充到Word文档的指定位置

有了数据源之后，我们需要将数据填充到Word文档中。通过结合循环和之前学习的技术（书签、查找替换、表格操作），我们可以实现灵活的数据填充。

1. using MudTools.OfficeInterop;
2. using MudTools.OfficeInterop.Word;
3. using System;
4. using System.Collections.Generic;
6. // 文档生成服务
7. public class DocumentGenerationService
8. {
9.     /// <summary>
10.     /// 生成员工工资条
11.     /// </summary>
12.     /// <param name="templatePath">模板路径</param>
13.     /// <param name="outputDirectory">输出目录</param>
14.     /// <param name="employees">员工数据列表</param>
15.     public void GeneratePaySlips(string templatePath, string outputDirectory, List<Employee> employees)
16.     {
17.         foreach (var employee in employees)
18.         {
19.             try
20.             {
21.                 // 基于模板创建新文档
22.                 using var wordApp = WordFactory.CreateFrom(templatePath);
23.                 var document = wordApp.ActiveDocument;
24.                
25.                 // 隐藏Word应用程序以提高性能
26.                 wordApp.Visibility = WordAppVisibility.Hidden;
27.                 wordApp.DisplayAlerts = WdAlertLevel.wdAlertsNone;
28.                
29.                 // 使用书签填充数据
30.                 FillDataUsingBookmarks(document, employee);
31.                
32.                 // 生成文件名
33.                 string fileName = $"工资条_{employee.Name}_{DateTime.Now:yyyyMM}.docx";
34.                 string outputPath = Path.Combine(outputDirectory, fileName);
35.                
36.                 // 保存文档
37.                 document.SaveAs(outputPath, WdSaveFormat.wdFormatXMLDocument);
38.                 document.Close();
39.                
40.                 Console.WriteLine($"已生成工资条: {fileName}");
41.             }
42.             catch (Exception ex)
43.             {
44.                 Console.WriteLine($"为员工 {employee.Name} 生成工资条时发生错误: {ex.Message}");
45.             }
46.         }
47.     }
48.    
49.     /// <summary>
50.     /// 使用书签填充数据
51.     /// </summary>
52.     /// <param name="document">Word文档</param>
53.     /// <param name="employee">员工数据</param>
54.     private void FillDataUsingBookmarks(IWordDocument document, Employee employee)
55.     {
56.         // 填充基本信息
57.         SetBookmarkText(document, "EmployeeName", employee.Name);
58.         SetBookmarkText(document, "EmployeeId", employee.Id.ToString());
59.         SetBookmarkText(document, "Department", employee.Department);
60.         SetBookmarkText(document, "PayPeriod", DateTime.Now.ToString("yyyy年MM月"));
61.         
62.         // 填充薪资信息
63.         SetBookmarkText(document, "BaseSalary", employee.Salary.ToString("C"));
64.         SetBookmarkText(document, "Bonus", employee.Bonus.ToString("C"));
65.         SetBookmarkText(document, "TotalIncome", (employee.Salary + employee.Bonus).ToString("C"));
66.         SetBookmarkText(document, "Deductions", "0.00");
67.         SetBookmarkText(document, "NetPay", (employee.Salary + employee.Bonus).ToString("C"));
68.         
69.         // 填充日期信息
70.         SetBookmarkText(document, "PayDate", DateTime.Now.ToString("yyyy年MM月dd日"));
71.         SetBookmarkText(document, "HireDate", employee.HireDate.ToString("yyyy年MM月dd日"));
72.     }
73.    
74.     /// <summary>
75.     /// 设置书签文本
76.     /// </summary>
77.     /// <param name="document">Word文档</param>
78.     /// <param name="bookmarkName">书签名称</param>
79.     /// <param name="text">文本内容</param>
80.     private void SetBookmarkText(IWordDocument document, string bookmarkName, string text)
81.     {
82.         try
83.         {
84.             var bookmark = document.Bookmarks[bookmarkName];
85.             if (bookmark != null)
86.             {
87.                 bookmark.Range.Text = text;
88.             }
89.         }
90.         catch (Exception ex)
91.         {
92.             Console.WriteLine($"设置书签 {bookmarkName} 文本时发生错误: {ex.Message}");
93.         }
94.     }
95.    
96.     /// <summary>
97.     /// 使用查找替换填充数据
98.     /// </summary>
99.     /// <param name="document">Word文档</param>
100.     /// <param name="employee">员工数据</param>
101.     private void FillDataUsingFindReplace(IWordDocument document, Employee employee)
102.     {
103.         // 使用查找替换填充数据
104.         document.FindAndReplace("[员工姓名]", employee.Name);
105.         document.FindAndReplace("[员工编号]", employee.Id.ToString());
106.         document.FindAndReplace("[部门]", employee.Department);
107.         document.FindAndReplace("[薪资月份]", DateTime.Now.ToString("yyyy年MM月"));
108.         document.FindAndReplace("[基本工资]", employee.Salary.ToString("C"));
109.         document.FindAndReplace("[奖金]", employee.Bonus.ToString("C"));
110.         document.FindAndReplace("[总收入]", (employee.Salary + employee.Bonus).ToString("C"));
111.         document.FindAndReplace("[扣除项]", "0.00");
112.         document.FindAndReplace("[实发工资]", (employee.Salary + employee.Bonus).ToString("C"));
113.         document.FindAndReplace("[发放日期]", DateTime.Now.ToString("yyyy年MM月dd日"));
114.         document.FindAndReplace("[入职日期]", employee.HireDate.ToString("yyyy年MM月dd日"));
115.     }
116. }

复制代码

应用场景：复杂企业级批量文档生成系统

在现代企业运营中，文档自动化处理已成为提升效率、确保合规性和改善客户体验的关键环节。通过结合循环和上文技术（书签、查找替换、表格操作），我们能够构建一个功能强大、灵活可扩展的企业级批量文档生成系统，满足各种复杂的业务需求。
特别值得一提的是，还可以集成SemanticKernel、ML.Net实现以下AI能力：

• 使用自然语言处理技术，自动生成个性化的绩效评语和职业发展建议
  
• 通过机器学习分析历史数据，预测可能的薪酬纠纷并提前预警
  
• 利用光学字符识别（OCR）技术，自动解析纸质文档并将其纳入数字工作流
  

1. // 批量文档生成系统
2. public class BatchDocumentGenerationSystem
3. {
4.     private readonly DataService _dataService;
5.     private readonly DocumentGenerationService _documentService;
6.    
7.     public BatchDocumentGenerationSystem()
8.     {
9.         _dataService = new DataService();
10.         _documentService = new DocumentGenerationService();
11.     }
12.    
13.     /// <summary>
14.     /// 批量生成员工工资条
15.     /// </summary>
16.     /// <param name="templatePath">模板路径</param>
17.     /// <param name="outputDirectory">输出目录</param>
18.     /// <param name="dataSourceType">数据源类型</param>
19.     /// <param name="dataSourcePath">数据源路径</param>
20.     public void BatchGeneratePaySlips(string templatePath, string outputDirectory,
21.         DataSourceType dataSourceType, string dataSourcePath)
22.     {
23.         try
24.         {
25.             // 确保输出目录存在
26.             if (!Directory.Exists(outputDirectory))
27.             {
28.                 Directory.CreateDirectory(outputDirectory);
29.             }
30.             
31.             // 根据数据源类型获取员工数据
32.             List<Employee> employees = dataSourceType switch
33.             {
34.                 DataSourceType.Database => _dataService.GetEmployeesFromDatabase(dataSourcePath),
35.                 DataSourceType.Excel => _dataService.GetEmployeesFromExcel(dataSourcePath),
36.                 DataSourceType.Json => _dataService.GetEmployeesFromJson(dataSourcePath),
37.                 _ => throw new ArgumentException("不支持的数据源类型")
38.             };
39.             
40.             Console.WriteLine($"从{dataSourceType}数据源获取到 {employees.Count} 名员工的数据");
41.             
42.             // 生成工资条
43.             _documentService.GeneratePaySlips(templatePath, outputDirectory, employees);
44.             
45.             Console.WriteLine($"批量工资条生成完成，共生成 {employees.Count} 份工资条");
46.         }
47.         catch (Exception ex)
48.         {
49.             Console.WriteLine($"批量生成工资条时发生错误: {ex.Message}");
50.         }
51.     }
52.    
53.     /// <summary>
54.     /// 批量生成客户合同
55.     /// </summary>
56.     /// <param name="templatePath">模板路径</param>
57.     /// <param name="outputDirectory">输出目录</param>
58.     /// <param name="customers">客户数据列表</param>
59.     public void BatchGenerateContracts(string templatePath, string outputDirectory, List<Customer> customers)
60.     {
61.         try
62.         {
63.             // 确保输出目录存在
64.             if (!Directory.Exists(outputDirectory))
65.             {
66.                 Directory.CreateDirectory(outputDirectory);
67.             }
68.             
69.             foreach (var customer in customers)
70.             {
71.                 try
72.                 {
73.                     // 基于模板创建新文档
74.                     using var wordApp = WordFactory.CreateFrom(templatePath);
75.                     var document = wordApp.ActiveDocument;
76.                     
77.                     // 隐藏Word应用程序以提高性能
78.                     wordApp.Visibility = WordAppVisibility.Hidden;
79.                     wordApp.DisplayAlerts = WdAlertLevel.wdAlertsNone;
80.                     
81.                     // 填充客户数据
82.                     FillCustomerContractData(document, customer);
83.                     
84.                     // 生成文件名
85.                     string fileName = $"合同_{customer.Name}_{DateTime.Now:yyyyMMdd}.docx";
86.                     string outputPath = Path.Combine(outputDirectory, fileName);
87.                     
88.                     // 保存文档
89.                     document.SaveAs(outputPath, WdSaveFormat.wdFormatXMLDocument);
90.                     document.Close();
91.                     
92.                     Console.WriteLine($"已生成合同: {fileName}");
93.                 }
94.                 catch (Exception ex)
95.                 {
96.                     Console.WriteLine($"为客户 {customer.Name} 生成合同时发生错误: {ex.Message}");
97.                 }
98.             }
99.             
100.             Console.WriteLine($"批量合同生成完成，共生成 {customers.Count} 份合同");
101.         }
102.         catch (Exception ex)
103.         {
104.             Console.WriteLine($"批量生成合同时发生错误: {ex.Message}");
105.         }
106.     }
107.    
108.     /// <summary>
109.     /// 填充客户合同数据
110.     /// </summary>
111.     /// <param name="document">Word文档</param>
112.     /// <param name="customer">客户数据</param>
113.     private void FillCustomerContractData(IWordDocument document, Customer customer)
114.     {
115.         // 使用书签填充数据
116.         SetBookmarkText(document, "CustomerName", customer.Name);
117.         SetBookmarkText(document, "CustomerAddress", customer.Address);
118.         SetBookmarkText(document, "CustomerPhone", customer.Phone);
119.         SetBookmarkText(document, "ContractDate", DateTime.Now.ToString("yyyy年MM月dd日"));
120.         SetBookmarkText(document, "ContractAmount", customer.ContractAmount.ToString("C"));
121.         SetBookmarkText(document, "ServiceDescription", customer.ServiceDescription);
122.         SetBookmarkText(document, "ContractTerm", customer.ContractTerm);
123.     }
124.    
125.     /// <summary>
126.     /// 设置书签文本
127.     /// </summary>
128.     /// <param name="document">Word文档</param>
129.     /// <param name="bookmarkName">书签名称</param>
130.     /// <param name="text">文本内容</param>
131.     private void SetBookmarkText(IWordDocument document, string bookmarkName, string text)
132.     {
133.         try
134.         {
135.             var bookmark = document.Bookmarks[bookmarkName];
136.             if (bookmark != null)
137.             {
138.                 bookmark.Range.Text = text;
139.             }
140.         }
141.         catch (Exception ex)
142.         {
143.             Console.WriteLine($"设置书签 {bookmarkName} 文本时发生错误: {ex.Message}");
144.         }
145.     }
146. }
148. /// <summary>
149. /// 数据源类型枚举
150. /// </summary>
151. public enum DataSourceType
152. {
153.     Database,
154.     Excel,
155.     Json
156. }
158. /// <summary>
159. /// 客户数据模型
160. /// </summary>
161. public class Customer
162. {
163.     public int Id { get; set; }
164.     public string Name { get; set; }
165.     public string Address { get; set; }
166.     public string Phone { get; set; }
167.     public decimal ContractAmount { get; set; }
168.     public string ServiceDescription { get; set; }
169.     public string ContractTerm { get; set; }
170. }

复制代码

实战：生成批量员工工资条或客户合同

创建一个完整的批量文档生成系统，展示如何实现数据驱动的文档处理。
创建工资条模板

创建一个工资条模板，其中包含用于数据填充的书签。

1. // 工资条模板创建器
2. public class PaySlipTemplateCreator
3. {
4.     /// <summary>
5.     /// 创建工资条模板
6.     /// </summary>
7.     /// <param name="templatePath">模板保存路径</param>
8.     public void CreatePaySlipTemplate(string templatePath)
9.     {
10.         try
11.         {
12.             // 创建新文档
13.             using var wordApp = WordFactory.BlankWorkbook();
14.             var document = wordApp.ActiveDocument;
15.             
16.             // 隐藏Word应用程序以提高性能
17.             wordApp.Visibility = WordAppVisibility.Hidden;
18.             wordApp.DisplayAlerts = WdAlertLevel.wdAlertsNone;
19.             
20.             // 设置文档格式
21.             SetupDocumentFormat(document);
22.             
23.             // 添加模板内容
24.             AddTemplateContent(document);
25.             
26.             // 添加书签
27.             AddBookmarks(document);
28.             
29.             // 保存为模板
30.             document.SaveAs(templatePath, WdSaveFormat.wdFormatXMLTemplate);
31.             document.Close();
32.             
33.             Console.WriteLine($"工资条模板已创建: {templatePath}");
34.         }
35.         catch (Exception ex)
36.         {
37.             Console.WriteLine($"创建工资条模板时发生错误: {ex.Message}");
38.         }
39.     }
40.    
41.     /// <summary>
42.     /// 设置文档格式
43.     /// </summary>
44.     /// <param name="document">Word文档</param>
45.     private void SetupDocumentFormat(IWordDocument document)
46.     {
47.         // 设置页面格式
48.         foreach (IWordSection section in document.Sections)
49.         {
50.             var pageSetup = section.PageSetup;
51.             pageSetup.PaperSize = WdPaperSize.wdPaperA4;
52.             pageSetup.Orientation = WdOrientation.wdOrientPortrait;
53.             pageSetup.TopMargin = 36;  // 0.5英寸
54.             pageSetup.BottomMargin = 36;
55.             pageSetup.LeftMargin = 36;
56.             pageSetup.RightMargin = 36;
57.         }
58.     }
59.    
60.     /// <summary>
61.     /// 添加模板内容
62.     /// </summary>
63.     /// <param name="document">Word文档</param>
64.     private void AddTemplateContent(IWordDocument document)
65.     {
66.         var content = document.Content;
67.         
68.         // 添加标题
69.         content.Text = "员工工资条\n\n";
70.         content.Font.Name = "微软雅黑";
71.         content.Font.Size = 16;
72.         content.Font.Bold = true;
73.         content.ParagraphFormat.Alignment = WdParagraphAlignment.wdAlignParagraphCenter;
74.         
75.         // 添加基本信息表格
76.         var infoRange = content.Duplicate;
77.         infoRange.Collapse(WdCollapseDirection.wdCollapseEnd);
78.         infoRange.Text = "基本信息\n";
79.         infoRange.Font.Size = 12;
80.         infoRange.Font.Bold = true;
81.         infoRange.ParagraphFormat.Alignment = WdParagraphAlignment.wdAlignParagraphLeft;
82.         
83.         // 创建基本信息表格（3行4列）
84.         var infoTable = document.Tables.Add(infoRange, 3, 4);
85.         infoTable.Borders.Enable = 1;
86.         infoTable.AllowAutoFit = true;
87.         
88.         // 设置表头
89.         infoTable.Cell(1, 1).Range.Text = "员工姓名";
90.         infoTable.Cell(1, 2).Range.Text = "[员工姓名]";
91.         infoTable.Cell(1, 3).Range.Text = "员工编号";
92.         infoTable.Cell(1, 4).Range.Text = "[员工编号]";
93.         
94.         infoTable.Cell(2, 1).Range.Text = "部门";
95.         infoTable.Cell(2, 2).Range.Text = "[部门]";
96.         infoTable.Cell(2, 3).Range.Text = "薪资月份";
97.         infoTable.Cell(2, 4).Range.Text = "[薪资月份]";
98.         
99.         infoTable.Cell(3, 1).Range.Text = "入职日期";
100.         infoTable.Cell(3, 2).Range.Text = "[入职日期]";
101.         infoTable.Cell(3, 3).Range.Text = "发放日期";
102.         infoTable.Cell(3, 4).Range.Text = "[发放日期]";
103.         
104.         // 添加薪资明细
105.         var salaryRange = infoRange.Duplicate;
106.         salaryRange.Collapse(WdCollapseDirection.wdCollapseEnd);
107.         salaryRange.Text = "\n薪资明细\n";
108.         salaryRange.Font.Size = 12;
109.         salaryRange.Font.Bold = true;
110.         salaryRange.ParagraphFormat.Alignment = WdParagraphAlignment.wdAlignParagraphLeft;
111.         
112.         // 创建薪资明细表格（4行2列）
113.         var salaryTable = document.Tables.Add(salaryRange, 4, 2);
114.         salaryTable.Borders.Enable = 1;
115.         salaryTable.AllowAutoFit = true;
116.         
117.         // 设置表头
118.         salaryTable.Cell(1, 1).Range.Text = "项目";
119.         salaryTable.Cell(1, 2).Range.Text = "金额";
120.         
121.         salaryTable.Cell(2, 1).Range.Text = "基本工资";
122.         salaryTable.Cell(2, 2).Range.Text = "[基本工资]";
123.         
124.         salaryTable.Cell(3, 1).Range.Text = "奖金";
125.         salaryTable.Cell(3, 2).Range.Text = "[奖金]";
126.         
127.         salaryTable.Cell(4, 1).Range.Text = "总收入";
128.         salaryTable.Cell(4, 2).Range.Text = "[总收入]";
129.         
130.         // 添加扣除项和实发工资
131.         var deductionRange = salaryRange.Duplicate;
132.         deductionRange.Collapse(WdCollapseDirection.wdCollapseEnd);
133.         deductionRange.Text = "\n";
134.         
135.         // 创建扣除项表格（3行2列）
136.         var deductionTable = document.Tables.Add(deductionRange, 3, 2);
137.         deductionTable.Borders.Enable = 1;
138.         deductionTable.AllowAutoFit = true;
139.         
140.         deductionTable.Cell(1, 1).Range.Text = "扣除项";
141.         deductionTable.Cell(1, 2).Range.Text = "[扣除项]";
142.         
143.         deductionTable.Cell(2, 1).Range.Text = "实发工资";
144.         deductionTable.Cell(2, 2).Range.Text = "[实发工资]";
145.         
146.         deductionTable.Cell(3, 1).Range.Text = "大写金额";
147.         deductionTable.Cell(3, 2).Range.Text = "人民币[大写实发工资]";
148.     }
149.    
150.     /// <summary>
151.     /// 添加书签
152.     /// </summary>
153.     /// <param name="document">Word文档</param>
154.     private void AddBookmarks(IWordDocument document)
155.     {
156.         // 定义书签映射
157.         var bookmarkMappings = new Dictionary<string, string>
158.         {
159.             { "EmployeeName", "[员工姓名]" },
160.             { "EmployeeId", "[员工编号]" },
161.             { "Department", "[部门]" },
162.             { "PayPeriod", "[薪资月份]" },
163.             { "HireDate", "[入职日期]" },
164.             { "PayDate", "[发放日期]" },
165.             { "BaseSalary", "[基本工资]" },
166.             { "Bonus", "[奖金]" },
167.             { "TotalIncome", "[总收入]" },
168.             { "Deductions", "[扣除项]" },
169.             { "NetPay", "[实发工资]" }
170.         };
171.         
172.         // 为每个占位符添加书签
173.         foreach (var mapping in bookmarkMappings)
174.         {
175.             AddBookmarkToPlaceholder(document, mapping.Key, mapping.Value);
176.         }
177.     }
178.    
179.     /// <summary>
180.     /// 为占位符添加书签
181.     /// </summary>
182.     /// <param name="document">Word文档</param>
183.     /// <param name="bookmarkName">书签名称</param>
184.     /// <param name="placeholder">占位符文本</param>
185.     private void AddBookmarkToPlaceholder(IWordDocument document, string bookmarkName, string placeholder)
186.     {
187.         try
188.         {
189.             var range = document.Content.Duplicate;
190.             if (range.FindAndReplace(placeholder, "") > 0)
191.             {
192.                 document.Bookmarks.Add(bookmarkName, range);
193.             }
194.         }
195.         catch (Exception ex)
196.         {
197.             Console.WriteLine($"为占位符 {placeholder} 添加书签时发生错误: {ex.Message}");
198.         }
199.     }
200. }

复制代码

完整的工资条生成系统

创建一个完整的工资条生成系统，整合数据读取、模板创建和文档生成功能。

1. using MudTools.OfficeInterop;
2. using MudTools.OfficeInterop.Word;
3. using System;
4. using System.Collections.Generic;
5. using System.IO;
7. // 完整的工资条生成系统
8. public class CompletePaySlipGenerationSystem
9. {
10.     private readonly DataService _dataService;
11.     private readonly PaySlipTemplateCreator _templateCreator;
12.     private readonly DocumentGenerationService _documentService;
13.    
14.     public CompletePaySlipGenerationSystem()
15.     {
16.         _dataService = new DataService();
17.         _templateCreator = new PaySlipTemplateCreator();
18.         _documentService = new DocumentGenerationService();
19.     }
20.    
21.     /// <summary>
22.     /// 运行完整的工资条生成流程
23.     /// </summary>
24.     /// <param name="dataSourceType">数据源类型</param>
25.     /// <param name="dataSourcePath">数据源路径</param>
26.     /// <param name="outputDirectory">输出目录</param>
27.     public void RunPaySlipGenerationProcess(DataSourceType dataSourceType, string dataSourcePath, string outputDirectory)
28.     {
29.         try
30.         {
31.             Console.WriteLine("开始工资条生成流程...");
32.             
33.             // 1. 创建模板（如果不存在）
34.             string templatePath = Path.Combine(outputDirectory, "工资条模板.dotx");
35.             if (!File.Exists(templatePath))
36.             {
37.                 _templateCreator.CreatePaySlipTemplate(templatePath);
38.             }
39.             
40.             // 2. 从数据源获取员工数据
41.             List<Employee> employees = GetEmployeeData(dataSourceType, dataSourcePath);
42.             if (employees == null || employees.Count == 0)
43.             {
44.                 Console.WriteLine("未获取到员工数据，流程终止");
45.                 return;
46.             }
47.             
48.             Console.WriteLine($"成功获取 {employees.Count} 名员工的数据");
49.             
50.             // 3. 生成工资条
51.             _documentService.GeneratePaySlips(templatePath, outputDirectory, employees);
52.             
53.             Console.WriteLine($"工资条生成流程完成，共生成 {employees.Count} 份工资条");
54.         }
55.         catch (Exception ex)
56.         {
57.             Console.WriteLine($"运行工资条生成流程时发生错误: {ex.Message}");
58.         }
59.     }
60.    
61.     /// <summary>
62.     /// 获取员工数据
63.     /// </summary>
64.     /// <param name="dataSourceType">数据源类型</param>
65.     /// <param name="dataSourcePath">数据源路径</param>
66.     /// <returns>员工数据列表</returns>
67.     private List<Employee> GetEmployeeData(DataSourceType dataSourceType, string dataSourcePath)
68.     {
69.         try
70.         {
71.             return dataSourceType switch
72.             {
73.                 DataSourceType.Database => _dataService.GetEmployeesFromDatabase(dataSourcePath),
74.                 DataSourceType.Excel => _dataService.GetEmployeesFromExcel(dataSourcePath),
75.                 DataSourceType.Json => _dataService.GetEmployeesFromJson(dataSourcePath),
76.                 _ => throw new ArgumentException("不支持的数据源类型")
77.             };
78.         }
79.         catch (Exception ex)
80.         {
81.             Console.WriteLine($"获取员工数据时发生错误: {ex.Message}");
82.             return new List<Employee>();
83.         }
84.     }
85.    
86.     /// <summary>
87.     /// 创建示例数据文件
88.     /// </summary>
89.     /// <param name="outputDirectory">输出目录</param>
90.     public void CreateSampleDataFiles(string outputDirectory)
91.     {
92.         try
93.         {
94.             // 创建示例JSON数据文件
95.             var sampleEmployees = new List<Employee>
96.             {
97.                 new Employee
98.                 {
99.                     Id = 1001,
100.                     Name = "张三",
101.                     Department = "技术部",
102.                     Salary = 15000,
103.                     Bonus = 3000,
104.                     HireDate = new DateTime(2020, 1, 15)
105.                 },
106.                 new Employee
107.                 {
108.                     Id = 1002,
109.                     Name = "李四",
110.                     Department = "销售部",
111.                     Salary = 12000,
112.                     Bonus = 5000,
113.                     HireDate = new DateTime(2019, 3, 22)
114.                 },
115.                 new Employee
116.                 {
117.                     Id = 1003,
118.                     Name = "王五",
119.                     Department = "人事部",
120.                     Salary = 10000,
121.                     Bonus = 2000,
122.                     HireDate = new DateTime(2021, 5, 10)
123.                 }
124.             };
125.             
126.             // 保存为JSON文件
127.             string jsonPath = Path.Combine(outputDirectory, "员工数据.json");
128.             var jsonContent = Newtonsoft.Json.JsonConvert.SerializeObject(sampleEmployees, Newtonsoft.Json.Formatting.Indented);
129.             File.WriteAllText(jsonPath, jsonContent);
130.             
131.             Console.WriteLine($"示例数据文件已创建: {jsonPath}");
132.         }
133.         catch (Exception ex)
134.         {
135.             Console.WriteLine($"创建示例数据文件时发生错误: {ex.Message}");
136.         }
137.     }
138. }
140. // 使用示例
141. class Program
142. {
143.     static void Main(string[] args)
144.     {
145.         var paySlipSystem = new CompletePaySlipGenerationSystem();
146.         
147.         // 创建输出目录
148.         string outputDirectory = @"C:\PaySlips";
149.         if (!Directory.Exists(outputDirectory))
150.         {
151.             Directory.CreateDirectory(outputDirectory);
152.         }
153.         
154.         // 创建示例数据文件
155.         paySlipSystem.CreateSampleDataFiles(outputDirectory);
156.         
157.         // 运行工资条生成流程
158.         string jsonPath = Path.Combine(outputDirectory, "员工数据.json");
159.         paySlipSystem.RunPaySlipGenerationProcess(DataSourceType.Json, jsonPath, outputDirectory);
160.         
161.         Console.WriteLine("工资条生成系统运行完成！");
162.     }
163. }

复制代码

总结

使用MudTools.OfficeInterop.Word库实现数据驱动的文档处理，包括传统的邮件合并功能简介和更灵活的自定义数据填充方案：

• 传统邮件合并功能：虽然库中未直接提供，但理解其原理有助于我们设计更好的自定义方案
  
• 自定义数据填充方案：
  
  
  
  • 从数据库（SQL Server）、Excel、JSON文件等数据源读取数据
    
  • 使用循环和上文技术（书签、查找替换、表格操作）将数据批量填充到Word文档的指定位置
    
  
  

通过实战示例，创建了一个完整的批量员工工资条生成系统，展示了这些功能在实际工作中的强大应用。这些技能在实际工作中非常有用，能够大大提高文档处理的效率和质量。
掌握了这些技巧后，将能够：

• 快速批量生成个性化文档，节省大量人工处理时间
  
• 整合来自不同数据源的信息，创建综合性的报告文档
  
• 实现真正的数据驱动文档生成，确保内容的准确性和一致性
  
• 构建企业级的文档自动化系统，提升整体办公效率
  

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！