A newer version of this page is available. Switch to the current version.

IConnectionProviderService Interface

If implemented, enables you to restore a data connection on deserializing a report.

Namespace: DevExpress.DataAccess.Wizard.Services

Assembly: DevExpress.DataAccess.v18.2.dll


public interface IConnectionProviderService
Public Interface IConnectionProviderService


You can use the IConnectionProviderService interface to restore the data connections of a report and its child DetailReportBand objects.

The following code illustrates an IConnectionProviderService implementation.

using DevExpress.DataAccess.ConnectionParameters;
using DevExpress.DataAccess.Sql;
using DevExpress.DataAccess.Wizard.Services;
// ...

public class CustomConnectionProviderService : IConnectionProviderService {
    public SqlDataConnection LoadConnection(string connectionName) {
        // Specify custom connection parameters.
        return new SqlDataConnection(connectionName, 
            new MsSqlConnectionParameters("localhost", "dataBaseName", "userName", "password", MsSqlAuthorizationType.Windows));

The following code adds a custom connection provider service to the XtraReport.PrintingSystem property before previewing the report.

using DevExpress.DataAccess.Wizard.Services;
using DevExpress.XtraReports.UI;
// ...

XtraReport report = new XtraReport();
report.PrintingSystem.AddService(typeof(IConnectionProviderService), new CustomConnectionProviderService());
ReportPrintTool pt = new ReportPrintTool(report);

The IConnectionProviderService.LoadConnection method will be invoked for each connection that was serialized into the report definition file. Using the connectionName parameter, you can specify necessary connection parameters and return a required SqlDataConnection object.

See Also