DataServiceConfiguration Class


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Manages the configuration of WCF Data Services.

Namespace:   System.Data.Services
Assembly:  System.Data.Services (in System.Data.Services.dll)


public sealed class DataServiceConfiguration : IDataServiceConfiguration


Gets a DataServiceBehavior object that defines additional behaviors of the data service.


Gets or sets whether the data service runtime should convert the type that is contained in the payload to the actual property type that is specified in the request.


Gets or sets the maximum number of change sets and query operations that are allowed in a single batch.


Gets or set the maximum number of changes that can be included in a single change set.


Gets or sets the maximum number of related entities that can be included in a single request by using the $expand operator.


Get or sets the maximum number of related entities that can be included in an $expand path in a single request.


Get or sets the maximum number of objects to insert that can be contained in a single POST request.


Get or sets the maximum number of items in each returned collection.


Gets or sets whether verbose errors should be returned by the data service.


Registers a data type with the data service runtime so that it can be used by a custom data service provider.


Determines whether the specified object is equal to the current object.(Inherited from Object.)


Serves as the default hash function. (Inherited from Object.)


Gets the Type of the current instance.(Inherited from Object.)


Adds a type to the list of types that are recognized by the data service.

System_CAPS_pubmethodSetEntitySetAccessRule(String, EntitySetRights)

Sets the permissions for the specified entity set resource.

System_CAPS_pubmethodSetEntitySetPageSize(String, Int32)

Sets the maximum page size for an entity set resource.

System_CAPS_pubmethodSetServiceOperationAccessRule(String, ServiceOperationRights)

Sets the permissions for the specified service operation.


Returns a string that represents the current object.(Inherited from Object.)

This example shows the code-behind page for a Northwind-based data service, with access granted to selected entity sets.

using System.Data.Services;
using System.Linq;
using System.ServiceModel.Web;

namespace NorthwindService
    public class Northwind : DataService<NorthwindEntities>
        // This method is called only once to initialize service-wide policies.
        public static void InitializeService(DataServiceConfiguration config)
            // Grant only the rights needed to support the client application.
           config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead 
                | EntitySetRights.WriteMerge 
                | EntitySetRights.WriteReplace );
            config.SetEntitySetAccessRule("Order_Details", EntitySetRights.AllRead
                | EntitySetRights.AllWrite);
            config.SetEntitySetAccessRule("Customers", EntitySetRights.AllRead);


.NET Framework
Available since 3.5

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top