使用数据源¶

您定义数据源之后，或者您有定义数据源的某个插件 dll 时，请在您想要使用数据源的工程中添加并启用插件。请参阅定义数据源。

要在您的 Kanzi Studio 项目中使用数据源，请选择 Window > Data Sources。

使用 Data Sources 窗口在您的项目中创建、设置和删除数据源，并将数据源中的数据对象连接到项目中的节点和资源。

创建数据源¶

在您可以在 Kanzi Studio 中创建数据源之前，您必须在 Kanzi Engine 插件中定义一个数据源。请参阅定义数据源。

要创建数据源：

在 Data Sources 窗口中单击 Create Data Source。
在 Create Data Source 窗口中设置：
- 将 Name 更改为您想要用于此数据源的名称。
- 将 Data Source Type 设置为您要创建的数据源类型。
单击 OK。
如果您的数据源需要您设置任何其他属性，请在 Data Sources 窗口中设置这些属性。在 Data Sources 窗口中，单击并设置该数据源的属性。

例如，单击以设置此数据源生成其数据对象的文件。
在 Data Sources 窗口中，单击数据源旁边的以从该数据源创建数据对象。

将鼠标悬停在数据对象上可查看该数据对象的数据类型和当前值。

当数据源插件从您的数据源创建数据对象时，您可以在工程中使用这些数据。请参阅使用数据对象。

使用数据对象¶

在您可以使用数据源中的数据之前，您必须在 Kanzi Engine 插件中定义一个数据源并创建一个数据源。请参阅定义数据源和创建数据源。

本节介绍如何使用布尔、浮点、整数和字符串数据对象类型。要了解如何使用列表数据对象类型，请参阅使用列表数据对象。

要使用数据对象：

在 Node Tree 中选择要使用数据源的节点（或其父节点之一），在 Properties 中添加 Data Context 属性，并将其设置为您要使用数据的数据源。

例如，将 Data Context 属性添加并设置到 RootPage 节点。

通过设置 Data Context 属性，您可以告知应用程序从哪个数据源接收数据。当您为一个节点设置 Data Context 属性时，其所有子节点都会继承 Data Context 属性的值。如果您想为某个子节点使用不同的数据上下文，请在该节点中添加 Data Context 属性，并将其设置为您想要使用的数据上下文。

小技巧

您可以通过从 Data Sources 窗口拖动数据对象并将其放到 Node Tree 中要分配该数据上下文的节点上来设置数据上下文。
将数据对象项的值绑定到该节点的属性，也就是您要在其中使用在 Data Context 属性中设置的数据：
- 对于单字段属性，从 Data Sources 窗口中拖动数据对象，并将其放到您希望从该数据对象获取值的属性上。
  
  Kanzi 创建一个绑定，将属性的值绑定到由 Data Context 属性设置的数据源中的数据对象。
- 对于具有多个字段的属性，在 Properties 中单击 + Add Binding，并在 Binding Editor 中设置：
  - 将 Property 到您要绑定数据对象的字段的属性。
  - 将 Property Field 到您想要绑定数据对象的属性字段。
  - 从 Data Sources 窗口拖动数据对象并将其放到 Binding Editor 的 Expression 窗口上。
  单击 Save。
  
  Kanzi 创建一个绑定，将您在 Property Field 属性中设置的属性字段的值绑定到由 Data Context 属性设置的数据源中的数据对象。

使用列表数据对象¶

在您可以使用数据源中的数据之前，您必须在 Kanzi Engine 插件中定义一个数据源并创建一个数据源。请参阅定义数据源和创建数据源。

本节介绍如何使用列表数据对象类型。要了解如何使用布尔、浮点、整数和字符串数据对象类型，请参阅使用数据对象。

要使用列表数据对象：

在 Node Tree 中，为您想要使用数据源数据的项目选择一个 Grid List Box 或 Trajectory List Box 3D 节点，或其父节点之一，在 Properties 中添加 Data Context 属性，并将其设置为您想要使用数据的数据源。

例如，将 Data Context 属性添加并设置到 RootPage 节点。

通过设置 Data Context 属性，您可以告知应用程序从哪个数据源接收数据。当您为一个节点设置 Data Context 属性时，其所有子节点都会继承 Data Context 属性的值。如果您想为某个子节点使用不同的数据上下文，请在该节点中添加 Data Context 属性，并将其设置为您想要使用的数据上下文。
在 Node Tree 中创建或选择列表框节点，并在 Properties 中添加并将 Item Template 属性设置为您希望列表框节点使用的预设模板，以显示数据源中列表数据对象的数据。请参阅使用 Grid List Box 节点和使用 Trajectory List Box 3D 节点。
从 Data Sources 窗口中将列表数据对象类型拖到列表框节点的 Items Source 属性。

Kanzi 创建一个绑定，将 Items Source 属性的值绑定到由 Data Context 属性设置的数据源中的列表数据对象。

使用 Items Source 属性可以设置数据对象，该对象为 Grid List Box 节点中的列表项提供数据。
在 Prefabs 中，选择您在列表框节点的 Item Template 属性中设置的预设，并将列表数据对象内部的数据对象绑定到定义列表项的节点属性上，以使用数据源中的数据填充列表框项。请参阅使用数据对象。

更新数据源¶

如果定义您的数据源的 Kanzi Engine 插件未更新您的数据源，您可以手动更新数据源。

您可以通过以下方式更新数据源：

要更新特定数据源，请在 Data Sources 窗口中，单击您要更新的数据源旁边的。当您更新数据源时，Kanzi Studio 会从该数据源创建数据对象。

将鼠标悬停在数据对象上可查看该数据对象的数据类型和当前值。
要更新工程或解决方案中的所有数据源，在 File > Update 中选择：
- Update Data Sources in Project 更新 Kanzi Studio 项目中的数据源。
- Update Data Sources in Solution 更新 Kanzi Studio 项目和引用项目中的数据源。
要使用脚本更新数据源，请参阅使用脚本创建和更新数据源。