ADO.NET Data Service Client Utility (DataSvcUtil.exe)

  • Article

Note

This topic describes new functionality in ADO.NET Data Services that is available as an update to the .NET Framework version 3.5 Service Pack 1. You can download and install the update from the Microsoft Download Center.

DataSvcUtil.exe is a command-line tool provided by ADO.NET Data Services that 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.

  • 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 .edmx File Overview.

For more information, see How to: Manually Generate Client Data Service Classes (ADO.NET Data Services).

Note

Only the DataSvcUtil.exe tool can be used to generate client data classes that support data binding.

The DataSvcUtil.exe tool is installed in the .NET Framework directory. In many cases, this is located in C:\Windows\Microsoft.NET\Framework\v3.5. For 64-bit systems, this is located in C:\Windows\Microsoft.NET\Framework64\v3.5. You can also access the DataSvcUtil.exe tool from the Visual Studio command prompt (Click Start, point to All Programs, point to Microsoft Visual Studio 2008, point to Visual Studio Tools, and then click Visual Studio 2008 Command Prompt). 

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 root URI of the data service.

/version:[1.0|2.0]

Specifies the highest accepted version of ADO.NET Data Services. The version is determined based on the DataServiceVersion attribute of the DataService element in the returned data service metadata. For more information, see Working with Multiple Versions of ADO.NET Data Services. When you specify the /dataservicecollection parameter, you must also specify /version:2.0 to enable data binding.

See Also

Other Resources

Generating the Data Service Client Library (ADO.NET Data Services)

How to: Add a Data Service Reference (ADO.NET Data Services)