Microsoft.SharePoint.Dsp Namespace

  • Article

Provides the base class for the data retrieval service adapters used in Microsoft Windows SharePoint Services.

The adapters define a protocol for data consumers to query heterogeneous data sources and for the data sources to return query results back to the consumers, integrating different types of data into a unified format so that they can be related, analyzed, and manipulated easily.

Each data retrieval service provides a data-binding scheme that enables data consumers and data servers to communicate with each other through SOAP or the object model of Windows SharePoint Services. The client side of the data retrieval services consists of data consumers such as applications, data-driven Web Parts, or data-bound server controls. The server side of the data retrieval services is a group of adapters, which are Web services that return XML data from different data sources or that perform data-manipulation operations in those data sources. The following adapters are used in Windows SharePoint Services:

The Microsoft.SharePoint.Dsp.Sts namespace has both an object model and a SOAP interface, while the other three namespaces have only an object model.

The adapters provide an object model that can be used by other Microsoft .NET Framework managed assemblies. Server components can load the assembly of a service directly, eliminating the overhead of calling the service through SOAP. All adapters implement the IDspAdapter interface of the Microsoft.SharePoint.Dsp namespace, and by dynamically loading the data retrieval service assemblies, the same client code can be written to talk to any of the adapters.

Classes

  Class Description
AllFields Used in a query to specify that all the fields be returned from the data source.
Authentication The Authentication class represents the authentication mode that is used to connect to the back-end server.
Connection Represents a connection to a data retrieval service adapter.
DataRoot Represents the root of the content document for a particular adapter instance.
DspAdapter Implements the IDspAdapter interface for use by the OleDbAdapter class in performing queries against OLE DB data sources.
DspQuery Defines the filter used in a query against a data source provider.
DSQuery Represents a query used by a data retrieval service.
Field Represents a single column in a query.
Fields Represents the collection of columns that are included in a query.
OrderField Represents the column by which the result is ordered.
PTQuery Represents a pass-through query.
QueryRequest Represents the request in a query.
QueryResponse Represents the response in a query.
Request Represents the request header in a query, containing information about the operation type and the document type of the query.
RequestHeader Represents the request header in a query.
Response Represents the response in a query.
ServerParameter Represents a server parameter required by the server containing the data source.
ServerParameterInfo Represents information about the parameters used by the server containing the data source.
Versions Represents the versions of the data retrieval service that are supported by an adapter or the versions being used in a query.

Interfaces

  Interface Description
IDspAdapter Provides a COM interface for clients to access a data retrieval service adapter locally.

Enumerations

  Enumeration Description
ColumnMappingType Indicates the type of XML format used for data returned in a query.
DocumentType Specifies the document type for a request.
MethodType Specifies the action of the request.
OrderDirection The OrderDirection enumeration specifies the direction in which a field or column is sorted.
PagingSupportType Indicates the type of paging that is supported for a query.
QueryType Specifies a type of query that is used in a request.
ResponseStatus Specifies the status of a query response.
ResultContentType Indicates the type of content that is returned through a query.