Написать скрипт на стороне клиента GridWeb

Разработчики могут писать сценарии на стороне клиента для элемента управления Aspose.Cells.GridWeb. Это означает, что можно вызвать функцию JavaScript на стороне клиента для выполнения конкретной задачи, связанной с элементом управления GridWeb. Например, разработчики могут писать функции JavaScript для отправки данных GridWeb на сервер или отображения предупреждающего сообщения при возникновении ошибки проверки и т. д.

В этом разделе эта функция объясняется с помощью примеров.

Написание сценариев на стороне клиента для Aspose.Cells.GridWeb

Основная информация

Aspose.Cells.GridWeb предоставляет два свойства, созданные специально для поддержки сценариев на стороне клиента:

• OnSubmitClientFunction
• OnValidationErrorClientFunction

Создайте функции JavaScript на странице ASPX и назначьте имена этих функций свойствам OnSubmitClientFunction и OnValidationErrorClientFunction.

Функция JavaScript, которая будет назначена свойству OnSubmitClientFunction, должна быть правильно определена, как показано ниже:

JavaScript

 function function_name(arg, cancelEdit)
{
//Add javascript code here

}

где параметр [arg] представляет команду, сгенерированную элементом управления. Команда может быть «Сохранить», «Отправить», «Отменить» и т. д., а параметр [cancelEdit] является логическим значением, которое указывает, отменен ли ввод пользователя или нет.

Любая функция JavaScript, назначенная свойству OnSubmitClientFunction, каждый раз вызывается элементом управления GridWeb перед отправкой данных GridWeb на сервер. Точно так же, если функция назначена свойству OnValidationErrorClientFunction, эта функция будет вызываться каждый раз при возникновении ошибки проверки.

Функции для сценариев на стороне клиента

Aspose.Cells.GridWeb также предоставляет функции, особенно для сценариев на стороне клиента. Эти функции можно использовать в функциях JavaScript, чтобы лучше контролировать Aspose.Cells.GridWeb. Эти клиентские функции включают следующее:

Функции	Описание
updateData(bool отменаEdit)	Обновляет все клиентские данные Aspose.Cells.GridWeb перед их отправкой на сервер. Если параметр cancelEdit имеет значение true, то GridWeb отбрасывает все вводимые пользователем данные.
проверить все()	Используется для проверки наличия ошибок проверки вводимых пользователем данных. В случае ошибки функция возвращает false, в противном случае — true.
submit(string arg, bool cancelEdit)	Вызовите эту функцию для обратной передачи или отправки данных на сервер. Эта функция выполняет обе задачи по обновлению данных и проверке ввода пользователя. Эта функция также может запускать командное событие на стороне сервера. Используйте параметр arg для передачи вашей команды. Например: команда СОХРАНИТЬ используется для нажатия кнопкиСохранять на панели команд элемента управления GridWeb, а команда CCMD:MYCOMMAND запускает событие CustomCommand.
setActiveCell (целая строка, целая колонка)	Используется для активации определенной ячейки.
setCellValue (строка int, столбец int, строковое значение)	Используется для помещения значения в любую ячейку, указанную с помощью номеров строк и столбцов.
getCellValue (целая строка, целочисленный столбец)	Возвращает значение любой указанной ячейки.
получить активную строку ()	Используется в сочетании с функцией getActiveColumn() для определения положения активной ячейки.
получитьактивеколонн()	Используется в сочетании с функцией getActiveRow() для определения положения активной ячейки.
получитьвыбордиапазона()	Возвращает последний выбранный диапазон.
установитьдиапазон выбора()	Выбирает заданный диапазон.
очистить выборки ()	Очищает все выделение, кроме текущей активной ячейки.
получить массив ячеек ()	Он используется с другими связанными функциями, такими как getCellName(), getCellValueByCell(), getCellRow() и getCellColumn(). Пожалуйста, прочитайте эту статью для получения дополнительной информации об использовании этой функции:Чтение значений ячеек GridWeb на стороне клиента
Чтобы создать тестовое приложение, содержащее клиентские сценарии, работающие с Aspose.Cells.GridWeb, выполните следующие действия:

1. Создайте функции JavaScript, которые будут вызываться GridWeb. Эти функции будут добавлены на страницу ASP.NET. тег.
2. Назначьте имена функций свойствам OnSubmitClientFunction и OnValidationErrorClientFunction.

Вывод примера кода показан ниже:

Проверка добавлена в ячейку C1

Добавьте недопустимое значение и нажмитеСохранять. Возникает ошибка проверки, и выполняется функция ValidationErrorFunction.

ValidationErrorFunction вызывается при ошибке проверки

Пока вы не введете допустимое значение, никакие данные не будут отправлены на сервер. Введите допустимое значение и нажмитеСохранять. ConfirmFunction выполняется.

ConfirmFunction вызывается перед отправкой данных GridWeb на сервер

For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// A client side JavaScript function that will be executed before submitting data to server
function ConfirmFunction(arg, cancelEdit) {
    // Showing a confirm dialog with some information where "this" refers to GridWeb
    return confirm("The control is " + this.id + "\nThe command is \"" + arg + "\".\nDo you want to continue?");
}
        
// A client side JavaScript function that will be executed whenever a validation error will occur
function ValidationErrorFunction() {
    // Showing an alert message where "this" refers to GridWeb
    alert(this.id + ": Please correct your input error.");
}

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Assigning the name of JavaScript function to OnSubmitClientFunction property of GridWeb
GridWeb1.OnSubmitClientFunction = "ConfirmFunction";

// Assigning the name of JavaScript function to OnValidationErrorClientFunction property of GridWeb
GridWeb1.OnValidationErrorClientFunction = "ValidationErrorFunction";

// Accessing the cells collection of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Accessing "B1" cell and add some text
GridCell cell = sheet.Cells[0, 1];
cell.PutValue("Date (yyyy-mm-dd):");

// Accessing "C1" cell and add to it custom expression validation to accept dates in yyyy-mm-dd format
cell = sheet.Cells[0, 2];
var validation = cell.CreateValidation(GridValidationType.CustomExpression, true);            
validation.RegEx = @"\d{4}-\d{2}-\d{2}";