GridViewBase.ValidateRow Event

Enables you to specify whether the focused row's data is valid, and whether the row can lose focus.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v14.2.dll

Declaration

C#

public event GridRowValidationEventHandler ValidateRow

VB.NET

Public Event ValidateRow As GridRowValidationEventHandler

Event Data

The ValidateRow event's handler receives an argument of the GridRowValidationEventArgs type. The following properties provide information specific to this event:

Property	Description
Culture	Gets the culture related to the validation. Inherited from ValidationEventArgs.
ErrorContent	Gets or sets an object that describes the validation error. Inherited from ValidationEventArgs.
ErrorType	Gets or sets the error type. Inherited from ValidationEventArgs.
Handled	Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route. Inherited from RoutedEventArgs.
IsValid	Gets or sets a value specifying whether the value is valid. Inherited from ValidationEventArgs.
OriginalSource	Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs.
RoutedEvent	Gets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs.
Row	Gets the processed row.
RowHandle	Gets the processed row's handle.
Source	Gets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs.
UpdateSource	Gets an object that invoked the BaseEdit.Validate event. Inherited from ValidationEventArgs.
Value	Gets the editor's new value. Inherited from ValidationEventArgs.

Remarks

Row validation is performed within the ValidateRow event handler. This event is automatically fired after the focused row's data has been modified and it is about to lose focus. To manually force row validation, call the DataViewBase.CommitEditing method.

The processed row is returned by the event parameter's GridRowValidationEventArgs.Row property. Its handle is returned by the GridRowValidationEventArgs.RowHandle. After cell values have been obtained, you can verify whether these values meet your validity criteria. If the row fails validation, set the event's IsValid parameter to false. Otherwise, leave the IsValid parameter set to true.

To learn more, see Validating Rows.

Examples