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": "http://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正版授權，或了解更多產品信息請點擊