WCF 数据服务客户端实用工具 (DataSvcUtil.exe)
DataSvcUtil.exe 是由 WCF 数据服务 提供的命令行工具,它使用开放式数据协议 (OData) 源,并生成从 .NET Framework 客户端应用程序或 Silverlight 客户端应用程序访问数据服务所需的客户端数据服务类。 通过使用以下元数据源,该实用工具可以生成数据类:
数据服务的根 URI。 该实用工具会请求描述数据服务所公开的数据模型的服务元数据文档。 有关更多信息,请参见 OData:服务元数据文档。
使用概念架构定义语言 (CSDL) 定义的数据模型文件 (.csdl),如 [MC-CSDL]:概念架构定义文件格式(可能为英文网页)规范中所定义。
使用随实体框架提供的实体数据模型工具创建的 .edmx 文件。 有关更多信息,请参见 [MC-EDMX]:用于数据服务打包格式的实体数据模型(可能为英文网页)规范。
有关更多信息,请参见如何:手动生成客户端数据服务类(WCF 数据服务)。
DataSvcUtil.exe 工具安装在 .NET Framework 目录中。 多数情况下,它位于 C:\Program Files\Microsoft WCF Data Services\5.0\bin\.NETFramework。 对于 64 位系统,则位于 C:\Program Files (x86)\Microsoft WCF Data Services\5.0\bin\.NETFramework。
语法
datasvcutil /out:file [/in:file | /uri:serviceuri] [/dataservicecollection] [/language:devlang] [/nologo] [/version:ver] [/help]
参数
选项 |
说明 |
---|---|
/dataservicecollection |
指定还生成了将对象绑定到控件所需的代码。 这是支持 Silverlight 应用程序所必需的。 |
/help - 或 - /? |
显示该工具的命令语法和选项。 |
/in:<file> |
指定 .csdl 或 .edmx 文件或该文件所在的目录。 |
/language:[VB|CSharp] |
指定生成的源代码文件的语言。 默认语言为 C#。 |
/nologo |
禁止显示版权信息。 |
/out:<file> |
指定包含生成的客户端数据服务类的源代码文件的名称。 |
/uri:<string> |
OData 源的 URI。 |
/version:[1.0|2.0|3.0] |
指定接受的最高 OData 版本。 版本是根据返回的数据服务元数据中的 DataService 元素的 DataServiceVersion 特性确定的。 有关更多信息,请参见数据服务版本管理(WCF 数据服务)。 指定 /dataservicecollection 参数时,还必须指定 /version:2.0 或更高版本才能启用数据绑定。 |