IDataServiceHost Interface

Reference

Definition

Namespace:: System.Data.Services

Assembly:: System.Data.Services.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Interface that specifies interactions between WCF Data Services and its hosting environment.

public interface class IDataServiceHost

public interface IDataServiceHost

type IDataServiceHost = interface

Public Interface IDataServiceHost

Derived: System.Data.Services.IDataServiceHost2

Remarks

Each component that hosts WCF Data Services, such as Windows Communication Foundation (WCF) must implement this interface. IDataServiceHost is the contract between WCF Data Services and its hosting environment. This abstraction allows the WCF Data Services runtime to be agnostic to any particular hosting environment. The interface provides WCF Data Services with access to inbound HTTP requests. A new object implementing this interface is instantiated for each HTTP request and is then used to inspect properties of the HTTP request and configure the HTTP response.

Properties

AbsoluteRequestUri	Gets an absolute URI that is the URI as sent by the client.
AbsoluteServiceUri	Gets an absolute URI that is the root URI of the data service.
RequestAccept	The transport protocol specified by the request accept header.
RequestAcceptCharSet	Gets a string representing the value of the `Accept-Charset` HTTP header.
RequestContentType	Gets the transport protocol specified by the content type header.
RequestHttpMethod	Gets the request method of GET, PUT, POST, or DELETE.
RequestIfMatch	Gets the value for the If-Match header on the current request.
RequestIfNoneMatch	Gets the value for the If-None-Match header on the current request.
RequestMaxVersion	Gets the value that identifies the highest version that the request client is able to process.
RequestStream	Gets the stream that contains the HTTP request body.
RequestVersion	Gets the value that identifies the version of the request that the client submitted, possibly null.
ResponseCacheControl	Gets a string value that represents cache control information.
ResponseContentType	Gets the transport protocol of the response.
ResponseETag	Gets an eTag value that represents the state of data in response.
ResponseLocation	Gets or sets the service location.
ResponseStatusCode	Gets or sets the response code that indicates results of query.
ResponseStream	Gets the response stream to which the HTTP response body will be written.
ResponseVersion	Gets the version used by the host in the response.

Methods

GetQueryStringItem(String)	Gets a data item identified by the identity key contained by the parameter of the method.
ProcessException(HandleExceptionArgs)	Handles a data service exception using information in the `args` parameter.

Applies to