'Declaration Public Event UpdateError As DataSetEventHandler
public event DataSetEventHandler UpdateError
Event Data
The event handler receives an argument of type DataSetEventArgs containing data related to this event. The following DataSetEventArgs properties provide information specific to this event.
| Property | Description |
|---|---|
| DataSet | The data set where the event has occurred. |
| Error | For an unsuccessful operation, information detailing the error. |
| Status | Success or failure status of the operation. In events occurring before operation and allowing to change the status argument, user code can change the status to indicate whether to proceed with the operation, skip or abort it. |
| Tables | Returns the table collection of the data set. Use this property to gain access to table data in 3-tier configuration, where the DataSet argument is not set because it resides on the client and the event is fired on the server. |
| TableViews | Returns the table view collection of the data set. Use this property to gain access to table view data in 3-tier configuration, where the DataSet argument is not set because it resides on the client and the event is fired on the server. |
Remarks
An unsuccessful update, including one resulting in an exception, triggers UpdateError event. If user code sets the event's Status argument to Continue, an update attempt is made again. This loop continues until either the update succeeds or UpdateError event code does not set Status to Continue. See Handling Update Errors on the Client for details.
If the error is a fatal failure (a program or physical error, see Handling Errors in Update), the Error argument contains the exception object describing the failure. If this is a concurrency conflict that could not be reconciled on the server (see Handling Concurrency Conflicts), the Error argument is set to null (Nothing in Visual Basic). In case of a concurrency conflict, the rows that failed update can be found in the DataSet using the properties RowError, HasErrors and C1DataTable.GetErrors.
See Also