DataService<T> Class

.NET Framework (current version)

Other Versions

The main entry point for developing an ADO.NET Data Service.

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

Inheritance Hierarchy

System::Object
System.Data.Services::DataService<T>

Syntax

C++

generic<typename T>
[ServiceBehaviorAttribute(InstanceContextMode = InstanceContextMode::PerCall)]
[AspNetCompatibilityRequirementsAttribute(RequirementsMode = AspNetCompatibilityRequirementsMode::Allowed)]
public ref class DataService : IRequestHandler

Type Parameters

T: Type that defines the data service.

Constructors

	Name	Description
	DataService<T>()	Creates a new data service that deploys data of the type indicated by the template class.

Properties

	Name	Description
	CurrentDataSource	Gets the data source instance currently being used to process the request.
	ProcessingPipeline	Gets an object that defines the events for the data service processing pipeline.

Methods

	Name	Description
	AttachHost(IDataServiceHost^)	Attaches the data service host to the data service identified by the parameter host.
	CreateDataSource()	Creates a data source of the template class that will be used by the data service.
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	HandleException(HandleExceptionArgs^)	Called when an exception is raised while processing a request.
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	OnStartProcessingRequest(ProcessRequestArgs^)	Called before processing each request. For batch requests, it is called one time for the top batch request and one time for each operation in the batch.
	ProcessRequest()	Processes an HTTP request.
	ProcessRequestForMessage(Stream^)	Processes an HTTP request.
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

The DataService<T> class does the basic integration of all components of the server system. A new data service that uses system defaults for authorization and caching is created by defining a class that derives from the DataService<T> class and by referencing a compatible data model.

The type of the DataService<T> must expose at least one property that returns an entity set that is an IQueryable<T> collection of entity types. This class must also implement the IUpdatable interface to enable updates to be made to entity resources.

Version Information

.NET Framework
Available since 3.5

Thread Safety

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