生成客户端数据服务类 (WCF Data Services)

实现开放式数据协议 (OData) 的数据服务可返回描述 OData 源公开的数据模型的服务元数据文档。 有关更多信息,请参见 OData:服务元数据文档。您可以使用 Visual Studio 中的“添加服务引用”对话框来添加对基于 OData 的服务的引用。 使用此工具在客户端项目中添加对 OData 源返回的元数据的引用时,将执行以下操作:

  • 从数据服务请求服务元数据文档并截获返回的元数据。

    备注

    返回的元数据作为 .edmx 文件存储在客户端项目中。此 .edmx 文件无法通过实体数据模型设计器打开,因为此文件的格式与实体框架所使用的 .edmx 文件的格式不相同。可以通过使用 XML 编辑器或任何文本编辑器查看此元数据文件。有关更多信息,请参见 [MC-EDMX]:用于数据服务打包格式的实体数据模型(可能为英文网页)规范。

  • 作为从 DataServiceContext 继承的实体容器类生成数据服务的表示形式。 此生成的实体容器类与实体数据模型工具生成的实体容器类似。 有关更多信息,请参见Object Services Overview (Entity Framework)

  • 为在服务元数据中发现的数据模型类型生成数据类。

  • 在项目中添加对 Microsoft.Data.Services.Client.dll 程序集的引用。

    备注

    安装 WCF 数据服务 5.0 版后,“添加服务引用”工具将自动添加对此新版本客户端库的引用,而不是添加对 .NET Framework 中包含的 System.Data.Services.Client.dll 版本的引用。如果出于某种原因您需要使用早期版本的 WCF 数据服务 客户端,则应手动添加对此库的 .NET Framework 版本的引用。有关更多信息,请参见如何:手动生成客户端数据服务类(WCF 数据服务)

有关更多信息,请参见如何:添加数据服务引用(WCF 数据服务)

还可以在命令提示符处使用 DataSvcUtil.exe 工具来生成客户端数据服务类。 有关更多信息,请参见如何:手动生成客户端数据服务类(WCF 数据服务)

客户端数据类型映射

当使用 Visual Studio 中的**“添加服务引用”**对话框或 DataSvcUtil.exe 工具生成基于 OData 源客户端数据类时,.NET Framework 数据类型会映射到数据模型中的基元类型,如下所示:

数据模型类型

.NET Framework 数据类型

Edm.Binary

Byte[]

Edm.Boolean

Boolean

Edm.Byte

Byte

Edm.DateTime

DateTime

Edm.Decimal

Decimal

Edm.Double

Double

Edm.Guid

Guid

Edm.Int16

Int16

Edm.Int32

Int32

Edm.Int64

Int64

Edm.SByte

SByte

Edm.Single

Single

Edm.String

String

有关更多信息,请参见 OData:基元数据类型

请参阅

概念

快速入门(WCF 数据服务)

其他资源

数据客户端 (WCF Data Services)