Preparing to Implement a Data Processing Extension
Before you implement your Reporting Services data processing extension, you should define the interfaces to implement. You may want to provide extension-specific implementations of the entire set of interfaces, or you may simply want to focus your implementation on a subset, such as the IDataReader and IDbCommand interfaces in which clients would interact primarily with a result set as a DataReader object and would use your Reporting Services data processing extension as a bridge between the result set and your data source.
If your Reporting Services data processing extension will not support a particular property or method, implement the property or method as no-operation. If a client expects a particular behavior, throw a NotSupportedException exception.
Note A no-operation implementation of a property or method only applies to the properties and methods of those interfaces that you choose to implement. Optional interfaces that you choose not to implement should be left out of your data processing extension assembly. For more information about whether an interface is required or optional, see the table later in this section.
Each Reporting Services data processing extension must provide the following functionality:
- Open a connection to a data source.
- Analyze a query and return a list of field names for the result set.
- Execute a query against the data source and return a row set.
- Pass single-valued parameters to the query.
- Iterate through rows in the row set and retrieve data.
Each data processing extension can be extended to include the following functionality:
- Analyze a query and return a list of parameter names used in the query.
- Analyze a query and return the list of fields by which the query is grouped.
- Analyze a query and return the list of fields by which the query is sorted.
- Provide a user name and password to connect to the data source that is independent of the connection string.
- Iterate through rows in the row set and retrieve auxiliary metadata about the data values.
- Aggregate data at the server.
The following table describes the available interfaces and whether implementation is required or optional.
|IDbConnection||Represents a unique session with a data source. In the case of a client/server database system, the session may be equivalent to a network connection to the server.||Required|
|IDbConnectionExtension||Represents additional connection properties that can be implemented by Reporting Services data processing extensions regarding security and authentication.||Optional|
|IDbTransaction||Represents a local transaction.||Required|
|IDbTransactionExtension||Represents additional transaction properties that can be implemented by Reporting Services data processing extensions.||Optional|
|IDbCommand||Represents a query or command that is used when connected to a data source.||Required|
|IDbCommandAnalysis||Represents additional command information for analyzing a query and returning a list of parameter names used in the query.||Optional|
|IDataParameter||Represents a parameter or name/value pair that is passed to a command or query.||Required|
|IDataParameterCollection||Represents a collection of all parameters relevant to a command or query.||Required|
|IDataReader||Provides a method of reading a forward-only, read-only stream of data from your data source.||Required|
|IDataReaderExtension||Provides a method of reading one or more forward-only streams of result sets, obtained by executing a command at a data source. This interface provides additional support for field aggregates.||Optional|
|IExtension||Provides the base class for a Reporting Services data processing extension. Also enables an implementer to include a localized name for the extension and to pass configuration settings from the configuration file to the extension.||Required|
You can implement data processing extensions in one of two ways:
- Your data processing extension classes can implement the .NET data provider interfaces and optionally the extended data processing extension interfaces provided by Reporting Services.
- Your data processing extension classes can implement the data processing extension interfaces provided by Reporting Services and optionally the extended data processing extension interfaces.
The data processing extension interfaces are identical to a subset of the .NET data provider interfaces, methods, and properties, whenever possible. For more information about implementing a full .NET data provider, see "Implementing a .NET Framework Data Provider" in your Microsoft .NET Framework SDK documentation.