Добавление пользоватской серверной функции проверки
Возможные сценарии использования
Иногда вам может потребоваться реализовать проверку данных на сервере. Aspose.Cells.GridWeb позволяет добавлять собственную серверную проверку данных. Вам нужно указать диапазон ячеек или область. Вы также можете установить клиентские функции проверки для обратных вызовов с собственной серверной проверкой.
Добавить пользовательскую функцию проверки на стороне сервера
Вам нужно установить класс проверки сервера, который реализует интерфейс GridCustomServerValidation с помощью атрибута GridValidation.ServerValidation. Вам также необходимо установить функцию проверки на стороне клиента (она должна быть написана на JavaScript на стороне клиента), эта функция обязательна для проверки данных на клиентском конце при обратном вызове. Вы можете установить строку сообщения об ошибке через свойства GridValidation.ErrorMessage и заголовок через свойства GridValidation.ErrorTitle для ваших нужд. Пожалуйста, ознакомьтесь с серией скриншотов, показывающих, как это работает (шаг за шагом) в данном сценарии после выполнения приведенного ниже примера кода. В примере вы не можете обновлять данные в ячейках B2:C3. Когда вы попытаетесь отредактировать эти ячейки на листе, вам будет предложено несколько сообщений об ошибках, и предыдущее значение будет восстановлено. Вы можете открыть окно консоли (в вашем браузере), чтобы печатать информацию/детали о ячейке для определенных событий.
Образец кода
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
| ----------------------------------------------- | |
| AddCustomServerSideFunctionValidation.aspx | |
| ----------------------------------------------- | |
| <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="AddCustomServerSideFunctionValidation.aspx.cs" Inherits="Aspose.Cells.GridWeb.Examples.AddCustomServerSideFunctionValidation" %> | |
| <%@ Register TagPrefix="acw" Namespace="Aspose.Cells.GridWeb" Assembly="Aspose.Cells.GridWeb" %> | |
| <!DOCTYPE html> | |
| <html xmlns="http://www.w3.org/1999/xhtml"> | |
| <head runat="server"> | |
| <link rel="stylesheet" href="/Scripts/jquery-ui.css" /> | |
| <script src="/Scripts/jquery-2.1.1.js"></script> | |
| <script src="/Scripts/jquery-ui.js"></script> | |
| <script type="text/javascript"> | |
| var lastselectvalue = null; | |
| var localvalue = {}; | |
| function myCellSelect(cell) { | |
| //Get the selected cell. | |
| var value = this.getCellValueByCell(cell); | |
| //Get the value to store. | |
| lastselectvalue = value; | |
| var key = this.acttab + "_" + this.getCellRow(cell) + "_" + this.getCellColumn(cell); | |
| //Store the respective cell's value. | |
| localvalue[key] = lastselectvalue; | |
| console.log("OnCellSelect: value:" + value + " row:" + this.getCellRow(cell) + ",col:" + this.getCellColumn(cell)); | |
| console.log("Last selected value:" + lastselectvalue); | |
| } | |
| function ValidationErrorClientFunctionCallback(cell, msg) { | |
| //Get the error message string. | |
| var errmsg1 = getattr(cell, "errmsg"); | |
| //Show the error message in the client dialog. | |
| alert(errmsg1); | |
| //Showing an alert message where "this" refers to GridWeb | |
| alert(this.id + "----> " + msg + " Previous value will be restored."); | |
| $("#errmsg").text(msg); | |
| console.log("Selected cell:" + " row:" + this.getCellRow(cell) + ",col:" + this.getCellColumn(cell)); | |
| //Get the GridWeb. | |
| var who = this; | |
| //Restore to valid value/previous value. | |
| who.setValid(cell); | |
| var key = this.acttab + "_" + this.getCellRow(cell) + "_" + this.getCellColumn(cell); | |
| lastselectvalue = localvalue[key]; | |
| setInnerText(cell.children[0], lastselectvalue); | |
| } | |
| </script> | |
| <title>Add Custom Server-side Function Validation</title> | |
| </head> | |
| <body> | |
| <form id="form1" runat="server"> | |
| <div> | |
| <div> | |
| <b>GridWeb Version: </b> | |
| <asp:Label ID="lblVersion" runat="server" Text="Label"></asp:Label> | |
| <br /> | |
| <acw:GridWeb ID="GridWeb1" runat="server" OnCellSelectedClientFunction="myCellSelect" Width="44%" Height="384px" ShowLoading="true" XhtmlMode="true" | |
| PresetStyle="Standard" EnableAJAX="true" EnableAsync="true" RenderHiddenRow="true" MaxColumn="15" MaxRow="21"> | |
| </acw:GridWeb> | |
| </div> | |
| </div> | |
| <span id="errmsg" style="color: red;"></span> | |
| </form> | |
| </body> | |
| </html> | |
| ----------------------------------------------- | |
| AddCustomServerSideFunctionValidation.aspx.cs | |
| ----------------------------------------------- | |
| using System; | |
| using System.Collections.Generic; | |
| using System.Linq; | |
| using System.Web; | |
| using System.Web.UI; | |
| using System.Web.UI.WebControls; | |
| using Aspose.Cells.GridWeb; | |
| using Aspose.Cells.GridWeb.Data; | |
| namespace Aspose.Cells.GridWeb.Examples | |
| { | |
| class MyServerValidation : GridCustomServerValidation | |
| { | |
| public string Validate(GridWorksheet sheet, int row, int col, string value) | |
| { | |
| if ((row == 1) || (row == 2)) | |
| { | |
| return "Value Not Passed!"; | |
| } | |
| else | |
| { | |
| return string.Empty; | |
| } | |
| } | |
| } | |
| public partial class AddCustomServerSideFunctionValidation : System.Web.UI.Page | |
| { | |
| protected void Page_Load(object sender, EventArgs e) | |
| { | |
| if (!IsPostBack && !this.GridWeb1.IsPostBack) | |
| { | |
| lblVersion.Text = GridWeb.GetVersion(); | |
| //Input values to B2:C3 cells in the active worksheet. | |
| GridWeb1.ActiveSheet.Cells["B2"].PutValue("This"); | |
| GridWeb1.ActiveSheet.Cells["C2"].PutValue("cannot"); | |
| GridWeb1.ActiveSheet.Cells["B3"].PutValue("be"); | |
| GridWeb1.ActiveSheet.Cells["C3"].PutValue("changed"); | |
| //Get the validations of the active sheet. | |
| var gridValidationCollection = GridWeb1.ActiveSheet.Validations; | |
| //Add data validation to range/area: B2:C3 | |
| GridValidation gv = gridValidationCollection.Add(new GridCellArea(1, 1, 2, 2)); | |
| //Set the validation type to custom server function. | |
| gv.ValidationType = GridValidationType.CustomServerFunction; | |
| //Set the server validation class which implements the GridCustomServerValidation interface. | |
| gv.ServerValidation = new MyServerValidation(); | |
| //Set the client validation function (written in JavaScript on client-side). | |
| //This function is compulsory to validate the data on client end on callback. | |
| gv.ClientValidationFunction = "ValidationErrorClientFunctionCallback"; | |
| //Set the error message string. | |
| gv.ErrorMessage = "Error found! You cannot change this value."; | |
| //Set the error title. | |
| gv.ErrorTitle = "Error"; | |
| } | |
| } | |
| } | |
| } |