演练:在 LightSwitch 中公开和使用 OData 服务

Visual Studio LightSwitch 应用程序可以将其数据公开为开放式数据协议 (odata) 服务,支持 OData 协议的所有应用程序都可以使用该服务。 本演练演示如何从 LightSwitch 应用程序和使用在第二 LightSwitch 中的应用程序公开数据。

创建主机应用程序

第一步是创建公开 OData 源的宿主应用程序。

创建宿主应用程序项目

  1. 在菜单栏上,选择**“文件”“新建项目”**。

  2. 在**“已安装模板”列表中,选择“LightSwitch 应用程序 (Visual Basic)”“LightSwitch 应用程序 (visual C#)”**。

  3. 在**“名称”字段中,请输入“联系宿主”,然后选择“确定”**按钮。

  4. 在**“解决方案资源管理器”中,打开“属性”的快捷菜单,然后选择“打开”**。

  5. 选择**“应用程序类型”选项卡,并在“客户端”下选择“Web”**。

    仅 Web 应用程序可以将其数据公开为服务。

添加数据源

  1. 在**“解决方案资源管理器”中选择“数据源”**。

  2. 在“项目”菜单上,选择“添加表格”。

  3. 在**“属性”窗口中,选择“名称”**属性,然后输入 Contact。

  4. 在数据设计器中,请添加以下字段:

    名称

    类型

    必需

    名称

    String

    True

    Phone

    电话号码

    False

    电子邮件

    电子邮件地址

    False

公开服务

  1. 在菜单栏上,依次选择**“调试”“启动调试”**。

    “联系宿主”应用程序将在浏览器窗口中打开。

  2. 复制 URL 的第一部分 (https://localhost:#####/)

    停止运行应用程序。 必须运行以显示服务。

创建客户端应用程序。

接下来的步骤是使用该 OData 服务来创建一个应用程序

创建客户端项目

  1. 打开 Visual Studio 的新实例。

  2. 在菜单栏上,选择**“文件”“新建项目”**。

  3. 在**“已安装模板”列表中,选择“LightSwitch 应用程序 (Visual Basic)”“LightSwitch 应用程序 (visual C#)”**。

  4. 在**“名称”字段中,请输入名称“联系人客户端”,然后选择“确定”**按钮。

添加数据源

  1. 在**“解决方案资源管理器”中选择“数据源”**。

  2. 在菜单栏上,依次选择**“项目”“添加数据源”**。

  3. 在**“附加数据源向导”中,选择“OData 服务”,然后再选择“下一步”**按钮。

  4. 在**“源地址”**字段中,请粘贴您从“联系人宿主”应用程序 (https://localhost:#####/) 复制的 URL,然后在最后一个反斜杠 (http:#####/ContactData.svc) 后输入“ContactData.svc”。

  5. 选择**“测试连接”**按钮。

  6. 在**“测试连接”对话框中,从列表中选择“联系人”,然后选择“测试”**按钮。

    短暂延迟后,“测试连接成功” 对话框应显示。

  7. 单击**“确定”按钮,然后选择“关闭”按钮关闭对话框,然后单击“下一步”**按钮。

  8. 展开**“实体”节点,选择“联系人”,然后选择“完成”**按钮。

    数据设计器将打开并显示您在“联系人宿主”项目中创建的表的架构。

添加屏幕

  1. 在**“解决方案资源管理器”中选择“屏幕”**。

  2. 在菜单栏上,依次选择**“项目”“添加屏幕”**。

  3. 在**“添加新屏幕”对话框中,选择“可编辑的网格屏幕”**。

  4. 在**“屏幕数据”列表中,选择“ApplicationDataData.Contacts”,然后选择“确定”**按钮。

此时,您可以运行应用程序并输入数据。 您输入的所有数据保存在联系宿主的内部数据库中。

后续步骤

本演练演示在设计时环境中耗时的 OData。 在发布联系宿主应用程序到运行 Internet 信息服务 (IIS) 的服务器或 Windows Azure 之后,必须更新客户端应用程序的**“OData 源地址”** 以与发布应用程序的 URL 匹配。

备注

如果在设计时环境中关闭“联系主机”应用程序并重新启动该程序,则 LocalHost URL 将更改,并且需要您在客户端项目中更新“OData 源点地址”

更新数据源

  1. 打开联系人客户端项目。

  2. 在**“解决方案资源管理器”中选择“ApplicationDataData”**。

  3. 在菜单栏上,依次选择**“项目”“更新 Datasource”**。

  4. 在**“附加数据源向导”中,选择“上一步”**按钮。

  5. 在**“源地址”**文本框中,请输入发布的“联系人宿主”应用程序(例如,https://www.contoso.com/ApplicationData.svc)的新 URL。

  6. 单击**“下一步”按钮,然后单击“完成”**按钮更新数据源。

请参见

概念

公开 LightSwitch 应用程序数据