When you edit a form bound to a Xomega data object, some of the data properties of the object may be validated automatically as you make changes to the fields. However, you still want to make sure that the object is validated before submitting its data via a service call. Xomega Framework makes validating UI data objects with all their properties and child objects extremely easy.
Here's a list of steps that you typically perform in this case.
- Call the Validate method on your data object with the force parameter set to true to revalidate the data objects, its properties and all child objects, even if they have been validated before. Each data property validates its own value(s), while the object may provide cross-field and other additional validations.
- After the validation, call the GetValidationErrors method on your data object to retrieve all errors and warnings that were generated during the validation process. The result is the ErrorList class from the Xomega Framework.
- Call the HasErrors message on the validation error list to test if it contains any errors. In this case, you can handle the errors according to your current error handling standards (e.g. by displaying them in a dialog), and stop further execution of the action.
The following snippet demonstrates these steps.
Code:
dataObj.Validate(true);
ErrorList valErr = dataObj.GetValidationErrors();
if (valErr.HasErrors())
{
Errors.Show(valErr);
return;
}
To learn how to actually implement various validations in Xomega Framework, read the following topics.