ASPxDashboard.ConnectionError Event

Allows you to override the default behavior if data store connection fails with current connection parameters.

Namespace : DevExpress.DashboardWeb

Assembly : DevExpress.Dashboard.v25.2.Web.WebForms.dll

NuGet Package : DevExpress.Web.Dashboard

Declaration

• C#
• VB.NET

public event ConnectionErrorWebEventHandler ConnectionError

Public Event ConnectionError As ConnectionErrorWebEventHandler

Event Data

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

Remarks

The ConnectionError event fires if connection to a data store fails with current connection parameters (for instance, the database is inaccessible). You can handle the ConnectionError event and override the default behavior in this case.

To override the default behavior, do the following:

• Check the data source name for which the event has been raised using the ConnectionErrorWebEventArgs.DataSourceName event parameter.
• Provide new connection parameters using the ConfigureDataConnectionEventArgs.ConnectionParameters property.
• Set the ConnectionErrorEventArgs.Handled property to true. This will cancel the default routine for providing connection parameters.

To cancel connecting to the data store, use the ConnectionErrorEventArgs.Cancel property.

To get the exception that caused the event, use the ConnectionErrorEventArgs.Exception property.

See Also

ASPxDashboard Class

ASPxDashboard Members

DevExpress.DashboardWeb Namespace