本主题提供有关开发和部署 WCF 数据服务的信息。 有关 WCF 数据服务的更多基本信息,请参阅Getting Started并概述。
开发 WCF 数据服务
当使用 WCF 数据服务来创建数据服务,支持开放式数据协议 (OData),必须在开发过程中执行以下基本任务:
-
定义数据模型
WCF 数据服务支持多种数据服务提供程序使您可以定义基于各种数据源,从关系数据库到后期绑定数据类型中的数据的数据模型。 有关详细信息,请参阅数据服务提供商。
-
创建数据服务
大多数基本数据服务公开一个从 xref:System.Data.Services.DataService`1 类继承的类和一个作为实体容器的命名空间限定名称的
T类型。 有关详细信息,请参阅 Defining WCF Data Services的信息。 -
配置数据服务
默认情况下,WCF 数据服务禁用对由实体容器公开的资源的访问。 xref:System.Data.Services.DataServiceConfiguration接口,您可以配置对资源的访问和服务操作,指定受支持的版本的 OData,并定义其他服务范围的行为,例如批处理行为或最大可返回的实体数在单个响应源中。 有关详细信息,请参阅数据服务配置。
本主题介绍如何使用 Visual Studio 主要的开发和部署数据服务。 将数据作为 OData 馈送公开的 WCF 数据服务提供的灵活性的信息,请参阅Defining WCF Data Services。
选择开发 Web 服务器
使用 Visual Studio 2015 为 ASP.NET 应用程序或 ASP.NET Web 站点开发 WCF 数据服务,可以在其上运行数据服务在开发过程中的 Web 服务器的选择。 以下 Web 服务器将与 Visual Studio 以使其更易于测试和调试你的本地计算机上的数据服务集成。
-
本地 IIS 服务器
创建 ASP.NET 应用程序或 Internet Information Services (IIS) 上运行的 ASP.NET Web 站点的数据服务时,我们建议您开发和测试您的数据服务在本地计算机上使用 IIS。 在 IIS 上运行数据服务更便于在调试过程中跟踪 HTTP 请求。 这还允许预先确定 IIS 访问数据服务所需的文件、数据库和其他资源所必须具备的权限。 若要在 IIS 上运行您的数据服务,你必须确保 IIS 和 Windows Communication Foundation (WCF) 是否安装且配置正确,并在文件系统和数据库中授予 IIS 帐户的访问权限。 有关详细信息,请参阅如何:开发在 IIS 上运行的 WCF 数据服务。
NOTE 必须使用管理员权限才能启用开发环境,以配置本地 IIS 服务器来运行 Visual Studio。
-
Visual Studio 开发服务器
Visual Studio 包含一个内置的 Web 服务器,Visual Studio 开发服务器,这是 ASP.NET 项目的默认 Web 服务器。 此 Web 服务器用于在开发过程中在本地计算机上运行的 ASP.NET 项目。 WCF Data Services 快速入门演示如何创建运行在 Visual Studio 开发服务器中的数据服务。
使用 Visual Studio 开发服务器开发数据服务时应注意以下限制:
-
该服务器只能在本地计算机上访问。
-
该服务器侦听
localhost和特定端口,而非端口 80,后者是 HTTP 消息的默认端口。 有关详细信息,请参阅 Visual Studio 中用于 ASP.NET Web 项目的 Web 服务器。 -
该服务器在当前用户帐户的上下文中运行数据服务。 例如,如果作为管理员级别的用户运行,在 Visual Studio 开发服务器中运行的数据服务将具有管理员级别特权。 这会导致数据服务能够访问在部署到 IIS 服务器时无权访问的资源。
-
该服务器不包含 IIS 的额外功能,如身份验证。
-
此服务器无法处理分块的 HTTP 流,从数据服务访问大型二进制数据时发送哪个响应是由 WCF 数据服务客户端的默认值。 有关详细信息,请参阅流式处理提供程序。
-
此服务器有问题的处理时间 (
.) 字符在 URL 中,即使此字符支持由 WCF 数据服务中的密钥值。
TIP 即使 Visual Studio 开发服务器可用于在开发过程中测试你的数据服务,应部署到运行 IIS 的 Web 服务器之后再次对其进行测试。
-
-
Microsoft Azure 开发环境
Windows Azure Tools for Visual Studio 包含一组集成的工具,用于开发 Visual Studio 中的 Windows Azure 服务。 使用这些工具,可以开发可部署到 Microsoft Azure 的数据服务,并且可以在部署之前在本地计算机上测试数据服务。 使用 Visual Studio 开发 Windows Azure 平台运行的数据服务时,请使用这些工具。 您可以下载 Windows Azure Tools 从 Visual Studio Microsoft Download Center。 有关开发 Windows Azure 运行的数据服务的详细信息,请参阅博文部署 OData 服务在 Windows Azure 中。
开发提示
开发数据服务时,应注意以下事项:
-
如果计划对用户进行身份验证或将访问权限限定给特定用户,请确定数据服务的安全要求。 有关更多信息,请参见 Securing WCF Data Services。
-
HTTP 检查程序在调试数据服务时会非常有帮助,通过它可以检查请求和响应消息的内容。 可以使用任何可显示原始数据包的网络数据包分析器检查发向数据服务的 HTTP 请求和来自数据服务的响应。
-
在调试数据服务时,你可能想要在常规操作期间从数据服务不获取有关错误的详细信息。 通过将 xref:System.Data.Services.DataServiceConfiguration.UseVerboseErrors* 中的 xref:System.Data.Services.DataServiceConfiguration 属性设置为
true并将数据服务类的 xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults* 特性的 xref:System.ServiceModel.Description.ServiceDebugBehavior 属性设置为true,可以从数据服务获取其他错误信息。 有关详细信息,请参阅文章调试 WCF 数据服务。 你也可以在 WCF 中查看 HTTP 消息传送层中出现的异常跟踪。 有关更多信息,请参见 Configuring Tracing。 -
数据服务通常开发为 ASP.NET 应用程序项目,但您还可以创建你的数据服务作为 ASP.NET Web 站点项目在 Visual Studio 中。 有关两种类型的项目之间的差异的信息,请参阅Web 应用程序项目与 Visual Studio 中的 Web 站点项目。
-
当使用创建数据服务添加新项由 ASP.NET 在 IIS 中承载在 Visual Studio 中,数据服务的对话框。 虽然 ASP.NET 和 IIS 是数据服务的默认主机,支持其他托管选项。 有关详细信息,请参阅承载数据服务。
部署 WCF 数据服务
WCF 数据服务在选择承载数据服务的过程方面很灵活。 Visual Studio 可用于将数据服务部署到以下平台:
-
承载有 IIS 的 Web 服务器
当数据服务开发为 ASP.NET 项目中时,它可以部署到 IIS Web 服务器通过使用标准 ASP.NET 部署过程。 Visual Studio 为 ASP.NET 中,具体取决于承载要部署的数据服务的 ASP.NET 项目类型提供了以下部署技术。
-
ASP.NET Web 应用程序的部署技术
-
ASP.NET 网站的部署技术
有关 ASP.NET 应用程序的部署选项的详细信息,请参阅的 Visual Studio 和 ASP.NET Web 部署概述。
TIP 在尝试将数据服务部署到 IIS 之前,请确保已测试了向运行 IIS 的 Web 服务器的部署。 有关详细信息,请参阅如何:开发在 IIS 上运行的 WCF 数据服务。
-
-
Microsoft Azure
您可以通过使用 Windows Azure Tools for Visual Studio 部署到 Windows Azure 数据服务。 您可以下载 Windows Azure Tools 从 Visual Studio Microsoft Download Center。 有关数据服务部署到 Windows Azure 的详细信息,请参阅博文部署 OData 服务在 Windows Azure 中。
部署注意事项
部署数据服务时,应注意以下事项:
-
当您部署使用 Entity Framework 提供程序访问 SQL Server 数据库的数据服务时,还可能需要通过数据服务部署传播数据结构和/或数据。 Visual Studio 可以自动创建脚本 (.sql 文件) 来执行此操作在目标数据库中,且这些脚本可以包含在 ASP.NET 应用程序的 Web 部署包。 有关详细信息,请参阅如何:部署具有 Web 应用程序项目的数据库。 为 ASP.NET 网站,你可以执行此操作通过使用Database Publishing Wizard Visual Studio 中。 有关详细信息,请参阅发布 SQL 数据库。
-
因为 WCF 数据服务包括基本的 WCF 实现,可以使用 Windows Server AppFabric 监控数据服务部署到 Windows Server 上运行的 IIS。 有关使用 Windows Server AppFabric 监控数据服务的详细信息,请参阅博文使用 Windows Server AppFabric 跟踪 WCF 数据服务。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
