ValidationModule.CustomInitializeRuleSet Event

Replaces the default InitializeRuleSet() implementation with custom logic.

Namespace: DevExpress.ExpressApp.Validation

Assembly: DevExpress.ExpressApp.Validation.v24.1.dll

NuGet Package: DevExpress.ExpressApp.Validation

Declaration

C#

public event EventHandler<HandledEventArgs> CustomInitializeRuleSet

VB.NET

Public Event CustomInitializeRuleSet As EventHandler(Of HandledEventArgs)

Event Data

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

Property	Description
Handled	Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing.

Remarks

To replace the ValidationModule.InitializeRuleSet method’s default logic, handle the ValidationModule.CustomInitializeRuleSet event and set its Handled argument to true in your Module. The following example demonstrates how to handle this event in the platform-agnostic Module:

File: MySolution.Module\Module.cs(.vb).

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Validation;
using System;
using System.ComponentModel;
// ...
public sealed partial class MySolutionModule : ModuleBase {
    // ...
    public override void Setup(XafApplication application) {
        base.Setup(application);
        application.SetupComplete += Application_SetupComplete;
    }
    private void Application_SetupComplete(object sender, EventArgs e) {
        ValidationModule vModule = (ValidationModule)Application.Modules.FindModule(typeof(ValidationModule));
        if(vModule != null) {
            vModule.CustomInitializeRuleSet += ValidationModule_CustomInitializeRuleSet;
        }
    }
    private void ValidationModule_CustomInitializeRuleSet(object sender, HandledEventArgs e) {
        // custom logic
        e.Handled = true;
    }
}

Visual Basic

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Validation
Imports System
Imports System.ComponentModel
' ...
Public NotInheritable Partial Class MySolutionModule
    Inherits ModuleBase
    ' ...
    Public Overrides Sub Setup(ByVal application As XafApplication)
        MyBase.Setup(application)
        AddHandler application.SetupComplete, AddressOf Application_SetupComplete
    End Sub
    Private Sub Application_SetupComplete(ByVal sender As Object, ByVal e As EventArgs)
        Dim vModule As ValidationModule = CType(Application.Modules.FindModule(GetType(ValidationModule)), ValidationModule)
        If vModule IsNot Nothing Then
            AddHandler vModule.CustomInitializeRuleSet, AddressOf ValidationModule_CustomInitializeRuleSet
        End If
    End Sub
    Private Sub ValidationModule_CustomInitializeRuleSet(ByVal sender As Object, ByVal e As HandledEventArgs)
        ' custom logic
        e.Handled = True
    End Sub
End Class