Share via


IDbConnectionExtension Interface

Represents additional connection properties that can be implemented by SQL Server Reporting Services data processing extensions.

Namespace:  Microsoft.ReportingServices.DataProcessing
Assemblies:   Microsoft.ReportingServices.SharePoint.UI.WebParts (in Microsoft.ReportingServices.SharePoint.UI.WebParts.dll)
  Microsoft.ReportingServices.Interfaces (in Microsoft.ReportingServices.Interfaces.dll)

Syntax

'Declaration
Public Interface IDbConnectionExtension _
    Inherits IDbConnection, IDisposable, IExtension
'Usage
Dim instance As IDbConnectionExtension
public interface IDbConnectionExtension : IDbConnection, 
    IDisposable, IExtension
public interface class IDbConnectionExtension : IDbConnection, 
    IDisposable, IExtension
type IDbConnectionExtension =  
    interface
        interface IDbConnection
        interface IDisposable
        interface IExtension
    end
public interface IDbConnectionExtension extends IDbConnection, IDisposable, IExtension

The IDbConnectionExtension type exposes the following members.

Properties

  Name Description
Public property ConnectionString Gets or sets the string used to open a database. (Inherited from IDbConnection.)
Public property ConnectionTimeout Gets the time to wait, while trying to establish a connection, before terminating the attempt and generating an error. (Inherited from IDbConnection.)
Public property Impersonate Sets the username of the user that is impersonated while queries are executed. This property is ignored by the report server if impersonation is not supported by the data provider.
Public property IntegratedSecurity Indicates whether the connection should use integrated security rather than supply a username and password.
Public property LocalizedName Gets the localized name of the extension to be displayed in a user interface. (Inherited from IExtension.)
Public property Password Gets or sets the password to use when connecting to the database. Overrides any password specified in the connection string.
Public property UserName Gets or sets the username to use when connecting to the database. Overrides any username specified in the connection string.

Top

Methods

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

Top

Remarks

The IDbConnectionExtension interface enables you to implement an extension of the IDbConnection interface, which adds additional functionality for authenticating a connection to a data source. The IDbConnectionExtension interface can be used to build a custom data processing extension. 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 IDbConnectionExtension interface directly, but creates an instance of a class that implements IDbConnectionExtension.

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