Session.Connection Property

Gets or sets an IDbConnection object associated with the session.

Namespace: DevExpress.Xpo

Assembly: DevExpress.Xpo.v24.1.dll

NuGet Packages: DevExpress.Win.PivotGrid, DevExpress.Win.TreeMap, DevExpress.Xpo

NuGet Package: DevExpress.Xpo

Declaration

C#

[DefaultValue(null)]
public IDbConnection Connection { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property Connection As IDbConnection

Property Value

Type	Default	Description
IDbConnection	null	An object which implements the IDbConnection interface.

Remarks

Use the OleDbConnection to access an Microsoft Access database and the SqlConnection to access an Microsoft SQL Server database.

Setting the Connection property throws the CannotChangePropertyWhenSessionIsConnectedException if the session is already connected to a database. Otherwise, it resets the Session.ConnectionString property’s value.

The Connection property returns null (Nothing in VB) if the pooled database connection with the Cached Data Store and Object Access Layer (SessionObjectLayer or SerializableObjectLayerClient) is used.