SqlDataSource.ConnectionName Property

Specifies the name of a data connection in the App.config file.

Namespace: DevExpress.DataAccess.Sql

Assembly: DevExpress.DataAccess.v23.2.dll

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

Declaration

C#

[DefaultValue(null)]
[LocalizableCategory(DataAccessStringId.PropertyGridConnectionCategoryName)]
public string ConnectionName { get; set; }

VB.NET

<DefaultValue(Nothing)>
<LocalizableCategory(DataAccessStringId.PropertyGridConnectionCategoryName)>
Public Property ConnectionName As String

Property Value

Type	Default	Description
String	null	A String value that specifies the data connection name in the App.config file.

Remarks

If you specify a data connection with the ConnectionName, the SqlDataSource.ConfigureDataConnection event does not fire.

To change connection parameters at runtime, create and register a service that implements the IConnectionProviderService interface.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ConnectionName property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

web-forms-dashboard-replace-sql-data-source-with-object-data-source-with-filtered-data/CS/ASPxDashboard/Default.aspx.cs#L30

sqlDS.LoadFromXml(dsXML);
sqlDS.ConnectionName = dataSource.ConnectionName;
sqlDS.Fill(query.Name);

VB.NET

web-forms-dashboard-replace-sql-data-source-with-object-data-source-with-filtered-data/VB/ASPxDashboard/Default.aspx.vb#L26

sqlDS.LoadFromXml(dsXML)
sqlDS.ConnectionName = dataSource.ConnectionName
sqlDS.Fill(query.Name)