SqlDataSource.ConnectionName Property

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

Namespace: DevExpress.DataAccess.Sql

Assembly: DevExpress.DataAccess.v24.1.dll

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

Declaration

C#

[LocalizableCategory(DataAccessStringId.PropertyGridConnectionCategoryName)]
[TypeConverter(typeof(ConnectionNameTypeConverter))]
public string ConnectionName { get; set; }

VB.NET

<TypeConverter(GetType(ConnectionNameTypeConverter))>
<LocalizableCategory(DataAccessStringId.PropertyGridConnectionCategoryName)>
Public Property ConnectionName As String

Property Value

Type	Description
String	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 snippets (auto-collected from DevExpress Examples) contain references 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);

winforms-dashboard-replace-sql-data-source-with-object-data-source-with-filtered-data/CS/WinFormsDashboard/ViewerForm.cs#L52

sqlDS.LoadFromXml(dsXML);
sqlDS.ConnectionName = "Connection";
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)

winforms-dashboard-replace-sql-data-source-with-object-data-source-with-filtered-data/VB/WinFormsDashboard/ViewerForm.vb#L54

sqlDS.LoadFromXml(dsXML)
sqlDS.ConnectionName = "Connection"
sqlDS.Fill(query.Name)