WCF Data Service Client Utility (DataSvcUtil.exe)
Important
WCF Data Services has been deprecated and will no longer be available for download from the Microsoft Download Center. WCF Data Services supported earlier versions of the Microsoft OData (V1-V3) protocol only and has not been under active development. OData V1-V3 has been superseded by OData V4, which is an industry standard published by OASIS and ratified by ISO. OData V4 is supported through the OData V4 compliant core libraries available at Microsoft.OData.Core. Support documentation is available at OData.Net, and the OData V4 service libraries are available at Microsoft.AspNetCore.OData.
RESTier is the successor to WCF Data Services. RESTier helps you bootstrap a standardized, queryable, HTTP-based REST interface in minutes. Like WCF Data Services before it, Restier provides simple and straightforward ways to shape queries and intercept submissions before and after they hit the database. And like Web API + OData, you still have the flexibility to add your own custom queries and actions with techniques you're already familiar with.
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. 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 AtomPub (RFC5023).
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.
The DataSvcUtil.exe tool is installed in the .NET Framework directory. In many cases, this is located in C:\Windows\Microsoft.NET\Framework\v4.0. For 64-bit systems, this is located in C:\Windows\Microsoft.NET\Framework64\v4.0. You can also access the DataSvcUtil.exe tool from Developer Command Prompt for Visual Studio.
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. |
/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] |
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. When you specify the /dataservicecollection parameter, you must also specify /version:2.0 to enable data binding. |