ASPxCardView.SettingsEditing Property

Provides access to the CardView’s editing settings.

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#
VB.NET

public ASPxCardViewEditingSettings SettingsEditing { get; }

Public ReadOnly Property SettingsEditing As ASPxCardViewEditingSettings

Property Value

Type	Description
ASPxCardViewEditingSettings	An ASPxCardViewEditingSettings object that contains the CardView’s editing settings.

Example

This example illustrates how to implement custom date validation in Batch Edit mode: 1) The ASPxClientCardView.BatchEditCardValidating event is used to check values on the client.2) The ASPxCardView.CardValidating event is used to check values on the server.3) The CardViewBatchEditSettings.AllowValidationOnEndEdit property allows switching between validation modes on the client side. If the variation between the HireDate and BirthDate columns is less than 18, input data is considered invalid and data update is not allowed.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/aspxcardview-how-to-implement-custom-date-validation-in-batch-edit-mode-t332396

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>

<%@ Register Assembly="DevExpress.Web.v15.2, Version=15.2.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" Namespace="DevExpress.Web" TagPrefix="dx" %>

<!DOCTYPE html>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title></title>
</head>
<body>
    <form id="form1" runat="server">
        <script type="text/javascript">
            function OnValidation(s, e) {
                if (!clientChkb.GetChecked()) {
                    return;
                }
                var grid = ASPxClientCardView.Cast(s);
                var cellInfo1 = e.validationInfo[grid.GetColumnByField("BirthDate").index];
                var cellInfo2 = e.validationInfo[grid.GetColumnByField("HireDate").index];
                var years = CheckYears(cellInfo1.value, cellInfo2.value);
                if (years == null || years < 18) {
                    cellInfo1.isValid = false;
                    cellInfo2.isValid = false;
                    cellInfo2.errorText = "Invalid difference between Hire Date and Birth Date";
                    cellInfo1.errorText = "Invalid difference between Hire Date and Birth Date";
                } else {
                    cellInfo1.isValid = true;
                    cellInfo2.isValid = true;
                }
            }
            function CheckYears(date1, date2) {
                if (!date1 || !date2)
                    return null;
                var msecPerYear = 1000 * 60 * 60 * 24 * 365;
                var years = (date2.getTime() - date1.getTime()) / msecPerYear;
                return years;
            }
        </script>
    <div>
        <dx:ASPxCheckBox ID="ASPxCheckBox1" runat="server" ClientInstanceName="clientChkb"
            Checked="true" Text="ClientValidation">
        </dx:ASPxCheckBox>
        <dx:ASPxCheckBox runat="server" ID="ASPxCheckBox2" AutoPostBack="true" OnCheckedChanged="ASPxCheckBox2_CheckedChanged" Checked="false" Text="Validate on the Save Changes button click"></dx:ASPxCheckBox>
        <dx:ASPxCardView ClientInstanceName="grid" DataSourceID="AccessDataSource1" KeyFieldName="EmployeeID" ID="ASPxCardView1" OnCardValidating="ASPxCardView1_CardValidating" runat="server" AutoGenerateColumns="False">
            <SettingsEditing Mode="Batch">
            </SettingsEditing>
            <Columns>
                <dx:CardViewTextColumn FieldName="EmployeeID" ReadOnly="True" VisibleIndex="0">
                </dx:CardViewTextColumn>
                <dx:CardViewTextColumn FieldName="LastName" VisibleIndex="1">
                </dx:CardViewTextColumn>
                <dx:CardViewTextColumn FieldName="FirstName" VisibleIndex="2">
                </dx:CardViewTextColumn>
                <dx:CardViewTextColumn FieldName="Address" VisibleIndex="3">
                </dx:CardViewTextColumn>
                <dx:CardViewDateColumn FieldName="BirthDate" VisibleIndex="4" Width="120px">
                </dx:CardViewDateColumn>
                <dx:CardViewDateColumn FieldName="HireDate" VisibleIndex="6" Width="120px">
                </dx:CardViewDateColumn>
            </Columns>
            <CardLayoutProperties>
                <Items>
                    <dx:CardViewCommandLayoutItem HorizontalAlign="Right" ShowNewButton="True">
                    </dx:CardViewCommandLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="EmployeeID">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="LastName">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="FirstName">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="Address">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="BirthDate">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="HireDate">
                    </dx:CardViewColumnLayoutItem>
                    <dx:EditModeCommandLayoutItem HorizontalAlign="Right">
                    </dx:EditModeCommandLayoutItem>
                </Items>
            </CardLayoutProperties>
            <ClientSideEvents BatchEditCardValidating="OnValidation" />
        </dx:ASPxCardView>
        <asp:AccessDataSource ID="AccessDataSource1" runat="server" DataFile="~/App_Data/nwind.mdb"
            SelectCommand="SELECT [EmployeeID], [LastName], [FirstName], [Address], [BirthDate], [HireDate] FROM [Employees]"></asp:AccessDataSource>        
    </div>

    </form>
</body>
</html>

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using DevExpress.Web;

public partial class _Default : System.Web.UI.Page
{
    private bool CheckYears(DateTime hireDate, DateTime birthDate)
    {
        TimeSpan span = hireDate - birthDate;
        if (span.TotalDays / 365 < 18)
            return false;
        else
            return true;
    }
    void AddError(Dictionary<CardViewColumn, string> errors, CardViewColumn column, string errorText)
    {
        if (errors.ContainsKey(column)) return;
        errors[column] = errorText;
    }

    protected void ASPxCheckBox2_CheckedChanged(object sender, EventArgs e)
    {
        ASPxCardView1.SettingsEditing.BatchEditSettings.AllowValidationOnEndEdit = !ASPxCheckBox2.Checked;
    }
    protected void ASPxCardView1_CardValidating(object sender, ASPxCardViewDataValidationEventArgs e)
    {
        DateTime birthDate = (DateTime)e.NewValues["BirthDate"];
        DateTime hireDate = (DateTime)e.NewValues["HireDate"];
        var result = CheckYears(hireDate, birthDate);
        if (!result)
        {
            AddError(e.Errors, ASPxCardView1.Columns["BirthDate"], "Invalid difference between Hire Date and Birth Date");
            AddError(e.Errors, ASPxCardView1.Columns["HireDate"], "Invalid difference between Hire Date and Birth Date");
            e.CardError = "Correct validation errors";
        }
        else
        {
            e.CardError = "Modifications aren't allowed in the online example. </br>If you need to test the data editing functionality, please download the example on your machine and run it locally.";
        }
    }

}

Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports DevExpress.Web

Partial Public Class _Default
    Inherits System.Web.UI.Page

    Private Function CheckYears(ByVal hireDate As Date, ByVal birthDate As Date) As Boolean
        Dim span As TimeSpan = hireDate.Subtract(birthDate)
        If span.TotalDays / 365 < 18 Then
            Return False
        Else
            Return True
        End If
    End Function
    Private Sub AddError(ByVal errors As Dictionary(Of CardViewColumn, String), ByVal column As CardViewColumn, ByVal errorText As String)
        If errors.ContainsKey(column) Then
            Return
        End If
        errors(column) = errorText
    End Sub

    Protected Sub ASPxCheckBox2_CheckedChanged(ByVal sender As Object, ByVal e As EventArgs)
        ASPxCardView1.SettingsEditing.BatchEditSettings.AllowValidationOnEndEdit = Not ASPxCheckBox2.Checked
    End Sub
    Protected Sub ASPxCardView1_CardValidating(ByVal sender As Object, ByVal e As ASPxCardViewDataValidationEventArgs)
        Dim birthDate As Date = CDate(e.NewValues("BirthDate"))
        Dim hireDate As Date = CDate(e.NewValues("HireDate"))
        Dim result = CheckYears(hireDate, birthDate)
        If Not result Then
            AddError(e.Errors, ASPxCardView1.Columns("BirthDate"), "Invalid difference between Hire Date and Birth Date")
            AddError(e.Errors, ASPxCardView1.Columns("HireDate"), "Invalid difference between Hire Date and Birth Date")
            e.CardError = "Correct validation errors"
        Else
            e.CardError = "Modifications aren't allowed in the online example. </br>If you need to test the data editing functionality, please download the example on your machine and run it locally."
        End If
    End Sub

End Class

<%@ Page Language="vb" AutoEventWireup="true" CodeFile="Default.aspx.vb" Inherits="_Default" %>

<%@ Register Assembly="DevExpress.Web.v15.2, Version=15.2.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" Namespace="DevExpress.Web" TagPrefix="dx" %>

<!DOCTYPE html>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title></title>
</head>
<body>
    <form id="form1" runat="server">
        <script type="text/javascript">
            function OnValidation(s, e) {
                if (!clientChkb.GetChecked()) {
                    return;
                }
                var grid = ASPxClientCardView.Cast(s);
                var cellInfo1 = e.validationInfo[grid.GetColumnByField("BirthDate").index];
                var cellInfo2 = e.validationInfo[grid.GetColumnByField("HireDate").index];
                var years = CheckYears(cellInfo1.value, cellInfo2.value);
                if (years == null || years < 18) {
                    cellInfo1.isValid = false;
                    cellInfo2.isValid = false;
                    cellInfo2.errorText = "Invalid difference between Hire Date and Birth Date";
                    cellInfo1.errorText = "Invalid difference between Hire Date and Birth Date";
                } else {
                    cellInfo1.isValid = true;
                    cellInfo2.isValid = true;
                }
            }
            function CheckYears(date1, date2) {
                if (!date1 || !date2)
                    return null;
                var msecPerYear = 1000 * 60 * 60 * 24 * 365;
                var years = (date2.getTime() - date1.getTime()) / msecPerYear;
                return years;
            }
        </script>
    <div>
        <dx:ASPxCheckBox ID="ASPxCheckBox1" runat="server" ClientInstanceName="clientChkb"
            Checked="true" Text="ClientValidation">
        </dx:ASPxCheckBox>
        <dx:ASPxCheckBox runat="server" ID="ASPxCheckBox2" AutoPostBack="true" OnCheckedChanged="ASPxCheckBox2_CheckedChanged" Checked="false" Text="Validate on the Save Changes button click"></dx:ASPxCheckBox>
        <dx:ASPxCardView ClientInstanceName="grid" DataSourceID="AccessDataSource1" KeyFieldName="EmployeeID" ID="ASPxCardView1" OnCardValidating="ASPxCardView1_CardValidating" runat="server" AutoGenerateColumns="False">
            <SettingsEditing Mode="Batch">
            </SettingsEditing>
            <Columns>
                <dx:CardViewTextColumn FieldName="EmployeeID" ReadOnly="True" VisibleIndex="0">
                </dx:CardViewTextColumn>
                <dx:CardViewTextColumn FieldName="LastName" VisibleIndex="1">
                </dx:CardViewTextColumn>
                <dx:CardViewTextColumn FieldName="FirstName" VisibleIndex="2">
                </dx:CardViewTextColumn>
                <dx:CardViewTextColumn FieldName="Address" VisibleIndex="3">
                </dx:CardViewTextColumn>
                <dx:CardViewDateColumn FieldName="BirthDate" VisibleIndex="4" Width="120px">
                </dx:CardViewDateColumn>
                <dx:CardViewDateColumn FieldName="HireDate" VisibleIndex="6" Width="120px">
                </dx:CardViewDateColumn>
            </Columns>
            <CardLayoutProperties>
                <Items>
                    <dx:CardViewCommandLayoutItem HorizontalAlign="Right" ShowNewButton="True">
                    </dx:CardViewCommandLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="EmployeeID">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="LastName">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="FirstName">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="Address">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="BirthDate">
                    </dx:CardViewColumnLayoutItem>
                    <dx:CardViewColumnLayoutItem ColumnName="HireDate">
                    </dx:CardViewColumnLayoutItem>
                    <dx:EditModeCommandLayoutItem HorizontalAlign="Right">
                    </dx:EditModeCommandLayoutItem>
                </Items>
            </CardLayoutProperties>
            <ClientSideEvents BatchEditCardValidating="OnValidation" />
        </dx:ASPxCardView>
        <asp:AccessDataSource ID="AccessDataSource1" runat="server" DataFile="~/App_Data/nwind.mdb"
            SelectCommand="SELECT [EmployeeID], [LastName], [FirstName], [Address], [BirthDate], [HireDate] FROM [Employees]"></asp:AccessDataSource>        
    </div>

    </form>
</body>
</html>

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

ASPxCardView.SettingsEditing Property

Declaration

Property Value

Example