ASPxTreeList.NodeValidating Event

Enables you to specify whether node data is valid, and whether the node can be updated.

Namespace: DevExpress.Web.ASPxTreeList

Assembly: DevExpress.Web.ASPxTreeList.v19.2.dll

Declaration

public event TreeListNodeValidationEventHandler NodeValidating
Public Event NodeValidating As TreeListNodeValidationEventHandler

Event Data

The NodeValidating event handler receives an argument of the TreeListNodeValidationEventArgs type. The following properties provide information specific to this event.

Property Description
EditorPropertiesErrors Specifies the collection of errors.
Errors Gets a collection of node errors.
HasErrors Gets whether the processed node has errors.
IsNewNode Gets whether the processed node is new.
Keys Gets a dictionary of field name/value pairs that represent the primary key of the node to validate.
NewValues Gets a dictionary that contains the values of the non-key field name/value pairs in the node to be validated.
NodeError Gets or sets the error text displayed within the Error Node.
OldValues Gets a dictionary that contains the original field name/value pairs in the node to validate.

Remarks

The ASPxTreeList.NodeValidating event is raised when a node is about to be updated, and allows you to implement server-side data validation. To manually force the validation, call the DoNodeValidation method.

To obtain the edited node's values, use the event parameter's TreeListNodeValidationEventArgs.NewValues property. The old values are returned by the TreeListNodeValidationEventArgs.OldValues property. If the value is invalid, use the TreeListNodeValidationEventArgs.Errors property to specify the error description text. As a result, an error icon will be displayed next to the invalid value. Pointing to the icon shows the hint with the error description.

NodeError_validation

To display the Error Node, specify the TreeListNodeValidationEventArgs.NodeError property. This node is automatically displayed below the Edit Form if the TreeListNodeValidationEventArgs.NodeError property is set to a not empty string.

To learn more, see Node Validation and Error Indication.

Examples

This example demonstrates how to check the validity of data entered by end-users into a node. Validation is implemented within the ASPxTreeList.NodeValidating event handler. In this sample, validation fails in the cases listed below:

  • the department isn't specified;
  • the budget is negative.

The image below shows the result:

NodeValidation

protected void ASPxTreeList1_NodeValidating(object sender, TreeListNodeValidationEventArgs e) {
    if ((int)e.NewValues["Budget"] < 0)
        e.Errors["Budget"] = "Negative values aren't allowed";
    if (e.NewValues["Department"] == null)
        e.Errors["Department"] = "Required field";
    if (e.Errors.Count != 0)
        e.NodeError = "Node update failed. Please check node values.";
}
See Also