SqlDataSource.ConnectionError Event

Fires after an attempt to establish a data connection has failed.

Namespace: DevExpress.DataAccess.Sql

Assembly: DevExpress.DataAccess.v24.1.dll

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

Declaration

C#

public event ConnectionErrorEventHandler ConnectionError

VB.NET

Public Event ConnectionError As ConnectionErrorEventHandler

Event Data

The ConnectionError event's data class is ConnectionErrorEventArgs. The following properties provide information specific to this event:

Property	Description
Cancel	Gets or sets whether the operation performed on the processed event should be canceled.
ConnectionName	Gets the name of the connection for which the event has been raised. Inherited from ConfigureDataConnectionEventArgs.
ConnectionParameters	Gets or sets parameters used to establish a connection to data. Inherited from ConfigureDataConnectionEventArgs.
Exception	Gets an exception that caused the ConnectionError event.
Handled	Gets or sets whether default actions are required to connect to a data store.

Remarks

The ConnectionError event occurs if the SqlDataSource.ConnectionParameters property is set and an attempt to establish a data connection fails.

Note

This event is not raised if the ConnectionName was configured instead.