IDbConnection Interface

Definition

Namespace:

Microsoft.ReportingServices.DataProcessing

Assemblies:

Microsoft.ReportingServices.Interfaces.dll, Microsoft.ReportingServices.SharePoint.UI.WebParts.dll

Represents an open connection to a data source, and is implemented by SQL Server Reporting Services data processing extensions that access relational databases.

public interface class IDbConnection : IDisposable, Microsoft::ReportingServices::Interfaces::IExtension

public interface IDbConnection : IDisposable, Microsoft.ReportingServices.Interfaces.IExtension

type IDbConnection = interface
    interface IDisposable
    interface IExtension

Public Interface IDbConnection
Implements IDisposable, IExtension

Derived

Microsoft.ReportingServices.DataProcessing.IDbConnectionExtension

Implements

IExtension IDisposable

Remarks

The IDbConnection interface enables you to implement a Connectionclass, which represents a unique session with a data source. The IDbConnection interface can be used to build a custom data provider. For more information about Connection classes, see Implementing a Connection Class for a Data Processing Extension.

An application does not create an instance of the IDbConnection interface directly, but creates an instance of a class that implements IDbConnection.

Classes that implement IDbConnection must implement all required members, and typically define additional members to add provider-specific functionality. Because IDbConnection inherits from IExtension, you must also implement the IExtension members as part of your Connection class.

When you implement from the IDbConnection interface, you should also implement the following constructors:

Class	Description
PrvConnection()	Initializes a new instance of the PrvConnection class.
PrvConnection(string connectionString )	Initializes a new instance of the PrvConnection class when given a string containing the connection string.

Properties

ConnectionString	Gets or sets the string used to open a database.
ConnectionTimeout	Gets the time to wait, while trying to establish a connection, before terminating the attempt and generating an error.
LocalizedName	Gets the localized name of the extension to be displayed in a user interface. (Inherited from IExtension)

Methods

BeginTransaction()	Begins a database transaction.
Close()	Closes the connection to the database.
CreateCommand()	Creates and returns a Command object associated with the connection.
Open()	Initializes a database connection with the settings specified by the ConnectionString property of the provider-specific Connection object.
SetConfiguration(String)	Used to pass custom configuration data to an extension. (Inherited from IExtension)