Компонент DataGridView предназначен для представления в виде таблицы данных из реляционных источников репозитория.
В качестве источника данных для компонента могут выступать следующие объекты репозитория: Запрос, Таблица, Представление, Присоединенная таблица.
Для работы компонента определите свойство mobj в режиме дизайнера или свойство IDataGridView.DataSet в режиме выполнения веб-формы. Список столбцов в таблице будет соответствовать списку полей выбранного источника. Видимость столбцов, а также настройки отображения заголовков и данных, могут быть настроены в свойстве columns.
По умолчанию в таблице используется страничный режим загрузки и отображения данных. Это позволяет минимизировать время выполнения запросов и ускорить работу всей веб-формы. Для управления режимом работы используйте свойства allowPaging, recordsCount, recordsLimit, showPaginationPanel.
В свойстве tableStyle для таблице может быть выбран один из чередующихся стилей оформления.
Если источником для компонента является Запрос, то необходимо учитывать следующую особенность для дальнейшей корректной работы сортировки: если в запросе имеются какие-либо ключевые слова, отличные от SELECT и FROM, то такой запрос нужно оформить как вложенный. Например, запрос вида «SELECT * FROM TABLE_DATA LIMIT 5000» перепишите следующим образом: «SELECT * FROM (SELECT * FROM TABLE_DATA LIMIT 5000) subquery».
Компонент имеет различный набор свойств, доступных в режиме дизайнера и режиме выполнения веб-формы.
name. Наименование компонента;
allowPaging. Признак использования разбиения данных на страницы;
borderColor. Цвет границы компонента;
color. Цвет фона компонента;
columns. Настройки отображения и оформления столбцов, а также данных в них;
coordinate. Координата верхнего левого угла компонента. Координаты могут быть указаны в пикселях или в процентах относительно размеров родительского компонента. Свойство доступно, если свойству position установлено значение absolute;
enabled. Признак доступности компонента пользователю;
enableSort. Признак наличия возможности сортировать столбцы таблицы;
flexGrow. Свойство определяет, какую пропорцию свободного пространства в контейнере необходимо выделить компоненту. Если для всех компонентов установлено значение 1, то свободное пространство в контейнере равномерно распределяется между компонентами. Если один из компонентов имеет значение 2, то ему выделяется в два раза больше свободного пространства и так далее. Свойство доступно, если свойству position установлено значение relative;
font. Настройки шрифта, используемого для отображения текста в компоненте. При необходимости можно загрузить пользовательские шрифты;
hint. Текст всплывающей подсказки;
mobj. Составное свойство, в котором задаётся ключ источника данных компонента;
padding. Отступ от границ компонента до его содержимого. Отступы могут быть указаны в пикселях или в процентах относительно размеров компонента;
popupMenu. Контекстное меню, отображаемое для компонента. В качестве значения укажите один из компонентов PopupMenu, размещённых на форме;
position. Способ позиционирования компонента на веб-форме или внутри компонента-контейнера. По умолчанию свойство имеет значение absolute, при этом компонент имеет фиксированное расположение и размер, определяемые свойствами coordinate и size. При значении relative положение и размеры компонента будут изменяться вместе с размерами компонента-контейнера. При этом свойство coordinate будет недоступно. Место расположения компонента будет определяться свойствами flexDirection, aligments, justifyContent родительского компонента, а размеры компонента будут изменяться, если свойство size задано в процентах;
recordsCount. Количество записей, отображаемых на отдельной странице таблицы;
recordsLimit. Лимит загружаемых записей из источника данных. При пустом значении в таблицу могут быть загружены все записи источника;
showHint. Признак отображения всплывающей подсказки при наведении курсора мыши на компонент;
showPaginationPanel. Признак отображения панели для постраничного перехода по записям в таблице;
size. Размеры компонента. Размеры могут быть указаны в пикселях или в процентах относительно размеров родительского компонента;
tableStyle. Чередующийся стиль, используемый в таблице;
visible. Признак видимости компонента на запущенной веб-форме.
BorderColor. Цвет границы компонента;
Color. Цвет фона компонента;
DataGridView. Настройки представления таблицы компонента;
Enabled. Признак доступности компонента для пользователя;
PopupMenu. Контекстное меню, отображаемое для компонента. В качестве значения укажите один из компонентов PopupMenu, размещённых на форме;
Text. Текст, отображаемый в компоненте;
Visible. Признак видимости компонента для пользователя.
Компонент имеет событие onSelectionChange, которое наступает при изменении отметки ячеек в таблице.

См. также: