ActiveReports使用教程：如何添加数据集

---

ActiveReports 是一款专注于 .NET 平台的报表控件，全面满足 HTML5、WinForm、ASP.NET、.NET Core、WPF 等平台下的中国式复杂报表设计和跨平台报表开发需求，作为专业的报表工具为全球超过 300,000 名开发者提供全面的报表解决方案。

点击下载ActiveReports正式版

在Page报表或RDL报表中，将报表连接到数据源后，为了获取要在报表中使用的字段列表，需要添加数据集。使用以下说明将数据集添加到报表中。

注意：CSV 数据源的数据集是在添加数据源时自动创建的。

这些步骤假定您已经添加了Page Report / RDL Report模板并将其连接到数据源。

1、在“报表资源管理器”中，右键单击数据源节点（默认为DataSource1），然后选择“添加数据集”选项或从“添加”按钮中选择“数据集...”。

2、在出现的“数据集” 对话框中，选择“常规”页面，然后输入数据集的名称。此名称显示为报表资源管理器中数据源图标的子节点。

3、在此对话框的“查询”页面上，从下拉列表中选择“命令类型”。

• 文本-允许用户在“查询”框中输入SQL查询或XML路径。
• StoredProcedure-允许用户在“查询”框中输入存储过程的名称。
• TableDirect-允许用户在“查询”框中输入表的名称。

4、单击“查询”框上方右上角的“验证数据集”图标以验证查询。

5、这些字段将自动添加到“数据集”对话框的“字段”页面中。对于XML数据，请使用有效的XPath表达式在“字段”页面上手动输入字段。

6、您还可以在对话框的其他页面上设置参数、过滤器和数据选项。

7、单击确定按钮关闭对话框。您的数据集和查询字段在报告资源管理器中显示为节点。

注意：如果您使用的是XML或JSON数据源提供程序，则必须使用“查询”页面上的XPath或JSONPath表达式提供XML路径或JSON路径，并在“数据集”对话框的“字段”页面上生成字段。有关详细信息，请参见以下示例。

XML数据的查询和字段设置

连接字符串

xmldata连接字符串的示例

xmldata=<people>
  <person>
    <name>
      <given>John</given>
      <family>Doe</family>
    </name>
  </person>
  <person>
    <name>
      <given>Jane</given>
      <family>Smith</family>
    </name>
  </person>
</people>;

查询页面上的XMLPath

与查询一起评估时，XMLPath表达式从XML数据源返回一个值。XML路径用斜杠（/）表示，方括号（[]）表示元素集合上的迭代。

例如：/ people / person / name

您还可以使用XML数据集查询生成器来构建XMLPath。单击“使用XML查询设计器编辑”图标以打开“XML数据集查询生成器”对话框，然后从树节点中选择XPath。

领域

设置查询后，请使用包含以下名称和值对的两个字段来构建Fields集合：

名称：given； 值：given

名称：family； 值：family

JSON数据的查询和字段设置

连接字符串

JSON数据连接字符串的示例。

jsondoc=C:\Data\customers.json;schemadata={
  "$schema": "//json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "address": {
      "type": "object",
      "properties": {
        "streetAddress": {
          "type": "string"
        },
        "city": {
          "type": "string"
        }
      },
      "required": [
        "streetAddress",
        "city"
      ]
    },
    "phoneNumber": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string"
          },
          "code": {
            "type": "integer"
          }
        },
        "required": [
          "location",
          "code"
        ]
      }
    }
  },
  "required": [
    "address",
    "phoneNumber"
  ]
}

查询页面上的JSONPath

与查询一起评估时，JSONPath表达式从JSON数据源返回一个值。JSON路径通常以点（.）表示，根对象为'$'。方括号（[]）表示元素的数组。

例如：$ .Customers [*]

您还可以使用JSON查询构建器构建JSONPath，可以通过JSON查询设计器图标编辑进行访问。JSON查询构建器显示从JSON模式获得的JSON数据的结构。您可以从树节点中选择JSONPath。您还可以选择创建多个数据集-只需选中“选择多个节点”选项，然后选择要添加为数据集的节点。

领域

设置查询后，请使用包含以下名称和值对的两个字段来构建Fields集合：

名称：CompanyName； 值：CompanyName

名称：ContactName； 值：ContactName

相关内容推荐：

下载试用>>>

ActiveReports使用教程：如何连接到数据源

ActiveReports使用教程：如何在.Net Core 平台中实现 HTTP Handlers 功能

---

想要购买ActiveReports正版授权，或了解更多产品信息请点击