WCF Data Service Client Utility (DataSvcUtil.exe)
DataSvcUtil.exe is a command-line tool provided by WCF Data Services that consumes an Open Data Protocol (OData) feed and generates the client data service classes that are needed to access a data service from a .NET Framework client application or a Silverlight client application. This utility can generate data classes by using the following metadata sources:
The root URI of a data service. The utility requests the service metadata document, which describes the data model exposed by the data service. For more information, see OData: Service Metadata Document.
A data model file (.csdl) defined by using the conceptual schema definition language (CSDL), as defined in the [MC-CSDL]: Conceptual Schema Definition File Format specification.
An .edmx file created by using the Entity Data Model tools that are provided with the Entity Framework. For more information, see the [MC-EDMX]: Entity Data Model for Data Services Packaging Format specification.
For more information, see How to: Manually Generate Client Data Service Classes (WCF Data Services).
The DataSvcUtil.exe tool is installed in the .NET Framework directory. In many cases, this is located in C:\Program Files\Microsoft WCF Data Services\5.0\bin\.NETFramework. For 64-bit systems, this is located in C:\Program Files (x86)\Microsoft WCF Data Services\5.0\bin\.NETFramework.
Syntax
datasvcutil /out:file [/in:file | /uri:serviceuri] [/dataservicecollection] [/language:devlang] [/nologo] [/version:ver] [/help]
Parameters
Option |
Description |
|---|---|
/dataservicecollection |
Specifies that the code required to bind objects to controls is also generated. This is required to support Silverlight applications. |
/help -or- /? |
Displays command syntax and options for the tool. |
/in:<file> |
Specifies the .csdl or .edmx file or a directory where the file is located. |
/language:[VB|CSharp] |
Specifies the language for the generated source code files. The language defaults to C#. |
/nologo |
Suppresses the copyright message from displaying. |
/out:<file> |
Specifies the name of the source code file that contains the generated client data service classes. |
/uri:<string> |
The URI of the OData feed. |
/version:[1.0|2.0|3.0] |
Specifies the highest accepted version of OData. The version is determined based on the DataServiceVersion attribute of the DataService element in the returned data service metadata. For more information, see Data Service Versioning (WCF Data Services). When you specify the /dataservicecollection parameter, you must also specify /version:2.0 or a later version to enable data binding. |
See Also
Tasks
How to: Add a Data Service Reference (WCF Data Services)
Concepts
Generating the Client Data Service Classes (WCF Data Services)