### C# WinForms 应用程序中使用 SQL 查询创建水晶报表 在C# WinForms应用程序中集成水晶报表并利用SQL查询来填充数据是一个常见的需求。这涉及到几个主要步骤，包括设置Crystal Reports组件、编写SQL查询以及配置数据集。 #### 准备工作环境 为了能够在WinForms应用里展示由SQL查询产生的报告，首先需要安装SAP Crystal Reports for Visual Studio扩展[^1]。该工具允许开发者通过Visual Studio界面设计报表布局，并连接到数据库获取实时的数据。 #### 编写SQL查询 假设有一个名为`Employees`的表存储员工信息，可以构建如下简单的SELECT语句来提取所需字段： ```sql SELECT EmployeeID, FirstName, LastName FROM Employees; ``` 此查询将返回所有记录中的EmployeeID、FirstName和LastName列作为基础数据源用于后续处理。 #### 配置DataSet并与Crystal Report关联 接下来，在项目内定义一个强类型的DataSet对象，它代表了来自上述SQL命令的结果集结构。之后，把这个DataSet实例绑定给新建立或已存在的.rpt文件（即水晶报表模板），从而实现动态加载数据至指定位置显示出来。 以下是具体操作方法的一个简化版本示例代码片段： ```csharp using System.Data.SqlClient; // 导入必要的命名空间 using CrystalDecisions.CrystalReports.Engine; // 建立与数据库之间的链接字符串 string connectionString = "your_connection_string_here"; // 初始化一个新的ReportDocument类的对象 ReportDocument crystalReport = new ReportDocument(); try { using (SqlConnection conn = new SqlConnection(connectionString)) { string query = @"SELECT EmployeeID, FirstName, LastName FROM Employees"; SqlDataAdapter adapter = new SqlDataAdapter(query, conn); DataSet dataSet = new DataSet(); adapter.Fill(dataSet); // 加载现有的RPT文件路径 crystalReport.Load(@"path_to_your_report_file.rpt"); // 将数据集分配给报表文档 crystalReport.SetDataSource(dataSet.Tables[0]); // 显示报表视图控件 crystalReportViewer.ReportSource = crystalReport; } } catch (Exception ex) { MessageBox.Show($"Error loading report: {ex.Message}"); } finally{ if(crystalReport != null){ crystalReport.Close(); crystalReport.Dispose(); } } ``` 这段代码展示了如何打开一个连接到SQL Server的方法，执行预编写的查询并将结果传递给水晶报表引擎以便进一步呈现给用户查看[^2]。