演练:在 LightSwitch 中公开和使用 OData 服务
Visual Studio LightSwitch 应用程序可以将其数据公开为开放式数据协议 (odata) 服务,支持 OData 协议的所有应用程序都可以使用该服务。本演练演示如何从 LightSwitch 应用程序和使用在第二 LightSwitch 中的应用程序公开数据。
创建主机应用程序
第一步是创建公开 OData 源的宿主应用程序。
创建宿主应用程序项目
在菜单栏上,选择**“文件”,“新建项目”**。
在**“已安装模板”列表中,选择“LightSwitch 应用程序 (Visual Basic)”或“LightSwitch 应用程序 (visual C#)”**。
在**“名称”字段中,请输入“联系宿主”,然后选择“确定”**按钮。
在**“解决方案资源管理器”中,打开“属性”的快捷菜单,然后选择“打开”**。
选择**“应用程序类型”选项卡,并在“客户端”下选择“Web”**。
仅 Web 应用程序可以将其数据公开为服务。
添加数据源
在**“解决方案资源管理器”中选择“数据源”**。
在“项目”菜单上,选择“添加表格”。
在**“属性”窗口中,选择“名称”**属性,然后输入 Contact。
在数据设计器中,请添加以下字段:
名称
类型
必需
名称
String
True
Phone
电话号码
False
电子邮件
电子邮件地址
False
公开服务
在菜单栏上,依次选择**“调试”、“启动调试”**。
“联系宿主”应用程序将在浏览器窗口中打开。
复制 URL 的第一部分 (https://localhost:#####/)
停止运行应用程序。必须运行以显示服务。
创建客户端应用程序。
接下来的步骤是使用该 OData 服务来创建一个应用程序
创建客户端项目
打开 Visual Studio 的新实例。
在菜单栏上,选择**“文件”,“新建项目”**。
在**“已安装模板”列表中,选择“LightSwitch 应用程序 (Visual Basic)”或“LightSwitch 应用程序 (visual C#)”**。
在**“名称”字段中,请输入名称“联系人客户端”,然后选择“确定”**按钮。
添加数据源
在**“解决方案资源管理器”中选择“数据源”**。
在菜单栏上,依次选择**“项目”、“添加数据源”**。
在**“附加数据源向导”中,选择“OData 服务”,然后再选择“下一步”**按钮。
在**“源地址”**字段中,请粘贴您从“联系人宿主”应用程序 (https://localhost:#####/) 复制的 URL,然后在最后一个反斜杠 (http:#####/ContactData.svc) 后输入“ContactData.svc”。
选择**“测试连接”**按钮。
在**“测试连接”对话框中,从列表中选择“联系人”,然后选择“测试”**按钮。
短暂延迟后,“测试连接成功” 对话框应显示。
单击**“确定”按钮,然后选择“关闭”按钮关闭对话框,然后单击“下一步”**按钮。
展开**“实体”节点,选择“联系人”,然后选择“完成”**按钮。
数据设计器将打开并显示您在“联系人宿主”项目中创建的表的架构。
添加屏幕
在**“解决方案资源管理器”中选择“屏幕”**。
在菜单栏上,依次选择**“项目”、“添加屏幕”**。
在**“添加新屏幕”对话框中,选择“可编辑的网格屏幕”**。
在**“屏幕数据”列表中,选择“ApplicationDataData.Contacts”,然后选择“确定”**按钮。
此时,您可以运行应用程序并输入数据。您输入的所有数据保存在联系宿主的内部数据库中。
后续步骤
本演练演示在设计时环境中耗时的 OData。在发布联系宿主应用程序到运行 Internet 信息服务 (IIS) 的服务器或 Windows Azure 之后,必须更新客户端应用程序的**“OData 源地址”** 以与发布应用程序的 URL 匹配。
说明 |
---|
如果在设计时环境中关闭“联系主机”应用程序并重新启动该程序,则 LocalHost URL 将更改,并且需要您在客户端项目中更新“OData 源点地址”。 |
更新数据源
打开联系人客户端项目。
在**“解决方案资源管理器”中选择“ApplicationDataData”**。
在菜单栏上,依次选择**“项目”、“更新 Datasource”**。
在**“附加数据源向导”中,选择“上一步”**按钮。
在**“源地址”**文本框中,请输入发布的“联系人宿主”应用程序(例如,https://www.contoso.com/ApplicationData.svc)的新 URL。
单击**“下一步”按钮,然后单击“完成”**按钮更新数据源。