Работа с событиями GridWeb
Все программисты должны быть знакомы со событиями и их назначением. События используются для отправки уведомлений об изменениях, которые могут произойти в элементе управления или классе. У Aspose.Cells.GridWeb есть несколько событий, которые можно использовать для выполнения определенных задач при наступлении определенных изменений в элементе управления.
Эта тема предоставляет введение во все события, поддерживаемые элементом управления Aspose.Cells.GridWeb, а также некоторую информацию о том, как обрабатывать эти события.
Работа с событиями Grid
Введение в события Grid
Элемент управления Aspose.Cells.GridWeb поддерживает несколько событий, которые позволяют более точно управлять выполнением операций при наступлении определенных событий в элементе управления. Полный список поддерживаемых событий элементом управления Aspose.Cells.GridWeb можно найти ниже.
События | Описание |
---|---|
CellCommand | Происходит, когда щелкается гиперссылка команды в ячейке. Когда это событие запускается, его параметр e.Argument предоставляет имя команды. |
CellDoubleClick | Происходит, когда ячейка дважды щелкается. |
CellError | Происходит, когда входное значение ячейки содержит ошибку. |
ColumnDeleted | Происходит, когда пользователь удаляет столбец из листа Excel с использованием клиентского меню. |
ColumnDeleting | Происходит, когда пользователь пытается удалить столбец из листа Excel, используя клиентское меню. |
ColumnDoubleClick | Происходит, если дважды щелкнуть на заголовке столбца. |
ColumnInserted | Происходит, когда пользователь вставляет столбец в лист Excel с использованием клиентского меню. |
CustomCommand | Происходит, когда пользователь нажимает на пользовательскую командную кнопку. |
LoadCustomData | Происходит, когда свойство EnableSession элемента управления установлено в false и необходимо загрузить данные листа Excel. Вы можете обработать это событие в режиме без сеансов для загрузки данных листа Excel из файла или базы данных. |
PageIndexChanged | Происходит, когда изменяется индекс листа элемента управления. |
RowDeleted | Происходит, когда пользователь удаляет строку из листа Excel с использованием клиентского меню. |
RowDeleting | Происходит, когда пользователь пытается удалить строку из листа Excel, используя клиентское меню. |
RowDoubleClick | Происходит, если дважды щелкнуть на заголовке строки. |
RowInserted | Происходит, когда пользователь вставляет строку в лист Excel с использованием клиентского меню. |
SaveCommand | Происходит, когда нажимается кнопка Сохранить. |
SheetDataUpdated | Происходит, когда элемент управления загрузил отправленные данные и обновил данные листа Excel. |
SheetTabClick | Происходит, когда щелкается вкладка листа. |
SubmitCommand | Происходит, когда нажимается кнопка Отправить. |
UndoCommand | Происходит, когда нажимается кнопка Отмена. |
AjaxCallFinished | Срабатывает, когда обновление элемента управления AJAX завершено (EnableAJAX должен быть установлен в true). |
CellModifiedOnAjax | Срабатывает, если ячейка изменена в вызове AJAX. |
OnAfterColumnFilter | Срабатывает после применения фильтра к столбцу. |
OnBeforeColumnFilter | Срабатывает перед применением фильтра к столбцу. |
Обработка событий сетки
Для выполнения определенной операции при срабатывании определенного события необходимо создать обработчик событий. Обработчик событий выполняет необходимую задачу при срабатывании определенного события. Ниже показаны шаги по обработке простого события сетки с использованием Visual Studio.
Шаг 1: Выбор события элемента управления Aspose.Cells.GridWeb
- Выберите элемент управления Aspose.Cells.GridWeb и откройте его диалоговое окно свойств справа.
- Нажмите кнопку Вкладка событий.
- Выберите событие. В этом примере выбрано событие SaveCommand.
Шаг 2: Создание обработчика событий
-
Дважды щелкните по событию в диалоговом окне свойств.
Двойной щелчок по выбранному событию
Когда событие дважды кликают, Visual Studio автоматически создает обработчик событий.
Обработчик событий, созданный Visual Studio
- Добавьте код для выполнения действия внутри обработчика событий.
Здесь добавлена одна строка кода, которая сохраняет содержимое сетки в файл Excel при нажатии кнопки Сохранить.
Чтобы получить больше информации, переместите курсор выше, чтобы увидеть некоторый код, и тогда вы узнаете, что Visual Studio достаточно умна, чтобы добавить обработчик событий для события SaveCommand GridWeb.
Шаг 3: Запуск вашего приложения
- Соберите и запустите приложение.
- Нажмите Сохранить.
Содержимое сетки сохраняется в файл Excel.
Приложение в режиме запуска