ISecureDataConverter Interface

OBSOLETE

This interface is obsolete. Use the DevExpress.DataAccess.ISecureDataConverter interface instead.

If implemented, enables the Web Report Designer to use a custom algorithm for storing data source connection strings on the client.

Namespace: DevExpress.XtraReports.Web.ClientControls

Assembly: DevExpress.XtraReports.v18.2.Web.dll

Declaration

C#

[Obsolete("This interface is obsolete. Use the DevExpress.DataAccess.ISecureDataConverter interface instead.")]
public interface ISecureDataConverter :
    ISecureDataConverter

VB.NET

<Obsolete("This interface is obsolete. Use the DevExpress.DataAccess.ISecureDataConverter interface instead.")>
Public Interface ISecureDataConverter
    Inherits ISecureDataConverter

Remarks

When the SQL Data Source wizard obtains connection strings from the Web.config file, only the connection name is serialized with the report definition.

You can register a custom connection string provider. Based on the registration mode you choose, all the connection parameters or the connection name only are serialized along with a report data source. When the report serialized with connection parameters is passed to the client, these parameters are encrypted by applying the MachineKey algorithm. To provide a custom encryption mechanism, use the ISecureDataConverter interface.

The following code illustrates an ISecureDataConverter implementation that stores connections in an XML file.

C#

using DevExpress.XtraReports.Web.ClientControls;
using System;
using System.Linq;
using System.Xml.Linq;
// ...

public class CustomSecureDataConverter : ISecureDataConverter {
    const string URI = @"E:\Temp\Connections.xml";
    const string XML_CONNECTION = "Connection";
    const string XML_ID = "Id";
    static XDocument document;
    static object lockObj = new object();

    static CustomSecureDataConverter() {
        document = XDocument.Load(URI);
    }

    public string Protect(string entity) {
        var id = Guid.NewGuid().ToString();
        lock (lockObj)
            document.Root.Add(new XElement(XML_CONNECTION, new XAttribute(XML_ID, id), entity));
        return id;
    }

    public string Unprotect(string protectedEntity) {
        return document.Root.Elements(XML_CONNECTION)
            .First(x => x.Attribute(XML_ID).Value == protectedEntity)
            .Value;
    }

    public static void Flush() {
        document.Save(URI);
    }
}

VB.NET

Imports DevExpress.XtraReports.Web.ClientControls
Imports System
Imports System.Linq
Imports System.Xml.Linq
' ...

Public Class CustomSecureDataConverter
    Implements ISecureDataConverter
    Const URI As String = "E:\Temp\Connections.xml"
    Const XML_CONNECTION As String = "Connection"
    Const XML_ID As String = "Id"
    Shared document As XDocument
    Shared lockObj As New Object()

    Shared Sub New()
        document = XDocument.Load(URI)
    End Sub

    Public Function Protect(entity As String) As String
        Dim id = Guid.NewGuid().ToString()
        SyncLock lockObj
            document.Root.Add(New XElement(XML_CONNECTION, New XAttribute(XML_ID, id), entity))
        End SyncLock
        Return id
    End Function

    Public Function Unprotect(protectedEntity As String) As String
        Return document.Root.Elements(XML_CONNECTION).First(Function(x) x.Attribute(XML_ID).Value = protectedEntity).Value
    End Function

    Public Shared Sub Flush()
        document.Save(URI)
    End Sub
End Class

A custom Data Converter implementation should be registered at the application startup (by calling the DefaultReportDesignerContainer.RegisterSecureDataConverter<T> method) and released in the Application_End event (by calling the Flush method).

C#

using DevExpress.XtraReports.Web.ReportDesigner;
// ...

protected void Application_Start(object sender, System.EventArgs e) {
    DefaultReportDesignerContainer.RegisterSecureDataConverter<CustomSecureDataConverter>();
}

protected void Application_End(object sender, System.EventArgs e) {
    CustomSecureDataConverter.Flush();
}

VB.NET

Imports DevExpress.XtraReports.Web.ReportDesigner
' ...

Protected Sub Application_Start(sender As Object, e As System.EventArgs)
    DefaultReportDesignerContainer.RegisterSecureDataConverter(Of CustomSecureDataConverter)()
End Sub

Protected Sub Application_End(sender As Object, e As System.EventArgs)
    CustomSecureDataConverter.Flush()
End Sub