Элементы управления DataGrid и DataGridView Для работы с табличными данными в.NET Framework 1.x использовался элемент управления DataGrid. Начиная с версии. - презентация

1 Элементы управления DataGrid и DataGridView Для работы с табличными данными в.NET Framework 1.x использовался элемент управления DataGrid. Начиная с версии 2.0, поддерживается более простой в использовании элемент управления DataGridView. В.NET Framework 3.x элемент DataGrid поддерживается ради совместимости с более ранними версиями. Единственная особенность DataGrid, которая не реализована в DataGridView, - иерархическое отображение информации из двух взаимосвязанных таблиц в одном элементе управления. В отличие от DataGrid для отображения информации из двух таблиц, связанных отношением master/detail, необходимо использовать два элемента DataGridView. Оба элемента управления используют стандартную архитектуру привязки данных.

2 Дополнительные возможности DataGridView по сравнению c DataGrid DataGridView поддерживает 6 встроенных типов столбцов ( только 2 в DataGrid). DataGrid отображает данные только из внешнего источника. DataGridView может отображать неподсоединенные данные (unbound data), которые хранятся в самом элементе управления; данные из подсоединенного источника; те и другие одновременно. Класс DataGridView содержит множество свойств и событий для форматирования и управления отображением данных. DataGridView позволяет зафиксировать (freeze) строки и столбцы и тем самым запретить их прокрутку; спрятать(hide) строки, столбцы и заголовки; предусмотреть подсказки (ToolTips) и меню (shortcut menus ) для отдельных ячеек, строк и столбцов.

3 Инициализация DataGridView Элемент управления DataGridView можно инициализировать без использования подсоединенного источника данных, путем добавления столбцов и строк в коллекции DataGridView.Columns и DataGridView.Rows. Можно заполнить DataGridView данными из подсоединенного источника. В классе определены свойства object DataSource { get; set; } Источник данных для DataGridView. string DataMember { get; set; } Имя таблицы или свойства для источников данных, которые содержат несколько таблиц или списков. Значение по умолчанию string.Empty.

4 Источник данных для DataGridView Класс DataGridView использует стандартную модель привязки данных, согласно которой источник данных может быть объектом любого типа, реализующего один из следующих интерфейсов: IList ( коллекции с IList, одномерные массивы); IListSource ( типы DataTable и DataSet); IBindingList ( класс BindingList )>) ; IBindingListView ( класс BindingSource). Рекомендуется использование BindingSource. Для источников с несколькими таблицами или списками можно использовать свойство DataMember объекта BindingSource для конкретизации источника. Если в качестве источника данных используется коллекция объектов ( а не данные, полученные из базы данных) следует присвоить свойству DefaultCellStyle.DataSourceNullValue значение null (вместо значения по умолчанию DBNull.Value).

5 Архитектура элемента управления DataGridView DataGridViewElement DataGridViewBand DataGridViewColumn DataGridViewButtonColum DataGridViewCheckBoxColumn DataGridViewComboBoxColumn DataGridViewImageColumn DataGridViewLinkColumn DataGridViewTextBoxColumn DataGridViewRow DataGridViewCell DataGridViewButtonCell DataGridViewCheckBoxCell DataGridViewComboBoxCell DataGridViewImageCell DataGridViewLinkCell DataGridViewTextBoxCell DataGridViewHeaderCell DataGridViewRowHeaderCell DataGridViewColumnHeaderCell DataGridViewTopLeftHeaderCell

6 Класс DataGridView public class DataGridView : public Control, ISupportInitialize DataGridViewColumnCollection Columns { get; } Коллекция столбцов таблицы. Класс DataGridViewColumnCollection реализует интерфейсы IList, ICollection и IEnumerable. DataGridViewRowCollection Rows { get; } Коллекция строк таблицы. Класс DataGridViewRowCollection реализует интерфейсы IList, ICollection и IEnumerable. DataGridViewCell Item [ int columnIndex, int rowIndex ] { get; set; } DataGridViewCell Item [ string columnName, int rowIndex ] { get; set; } Ячейка таблицы на пересечении столбца и строки. Свойства класса для доступа к коллекциям столбцов(column), строк(row) и ячейке(cell).

7 Класс DataGridView DataGridViewRow CurrentRow { get; } Строка, содержащая текущую ячейку. DataGridViewCell CurrentCell { get; set; } Текущая ячейка. Point CurrentCellAddress { get; } Индексы столбца (X) и строки (Y) текущей ячейки. Свойства для доступа к текущей (current) строке и ячейке.

8 Класс DataGridViewColumn virtual DataGridViewCell CellTemplate { get; set; } Шаблон для всех ячеек в столбце. Значение по умолчанию null. string DataPropertyName { get; set; } Имя свойства или столбца таблицы в источнике данных для заполнения столбца. Type ValueType { get; set; } Тип значений в ячейках столбца. Класс DataGridViewColumn определяет внешний вид и функциональность ячейки таблицы. В классе определены два открытых конструктора – без параметров и конструктор DataGridViewColumn( DataGridViewCell cellTemplate ); который присваивает значение cellTemplate свойству, определяющему шаблон для всех ячеек в столбце.

9 Класс DataGridViewRow DataGridViewCellCollection Cells { get; } Коллекция ячеек в данной строке таблицы. Класс DataGridViewCellCollection реализует интерфейсы IList, ICollection и IEnumerable. В коллекции определен индексатор с параметром типа string, который дает доступ к значению в ячейке по имени столбца. bool IsNewRow { get; } true, если это последняя строка DataGridView, в которую вводятся значения. bool SetValues ( object[] values ); Метод дает возможность присвоить значения всем ячейкам строки. Если число элементов массива не совпадает с числом ячеек, метод возвращает значение false. Класс DataGridViewRow содержит коллекцию ячеек, которые находятся в строке, и используется для доступа к отдельной ячейке. Класс имеет только один открытый конструктор без параметров.

10 Класс DataGridViewCell Класс описывает отдельную ячейку элемента управления DataGridViewCell. Абстрактный класс, который имеет только защищенный (protected) конструктор. Object Value { get; set; } Значение в ячейке DataGridView. virtual Type ValueType { get; set; } Тип значения ячейки. Если не установлен для конкретной ячейки, используется тип данных столбца. Object FormattedValue { get; } Значение в ячейке DataGridView, после форматирования. virtual Type FormattedValueType { get; } Тип отформатированного значения в ячейке.

11 Типы столбцов в DataGridView DataGridViewTextBoxColumn Создается автоматически для строк и чисел при подсоединении источника. DataGridViewCheckBoxColumn Создается автоматически для значений типа Boolean и CheckState при подсоединении источника. DataGridViewImageColumn Для вывода изображений в столбце. Создается автоматически при соединении с массивами байт (byte arrays), Image или Icon. DataGridViewButtonColumn Используется для вывода кнопок в ячейках. Создается вручную. DataGridViewComboBoxColumn Используется для вывода открывающихся списков в ячейках. Создается вручную. DataGridViewLinkColumn Используется для вывода ссылок в ячейках. Создается вручную.

12 Тип столбца DataGridViewComboBoxColumn Ячейки столбца содержат элементы управления ComboBox (открывающийся список). Удобно использовать для выбора элемента из конечного множества значений. Нельзя создать автоматически при подсоединении источника данных. Необходимо создать явно и добавить к коллекции столбцов DataGridView, которая доступна через свойство DataGridView.Columns. Класс имеет только один открытый конструктор (без параметров) и большую часть методов и свойств наследует от базового класса DataGridViewColumn. Список встроенного ComboBox инициализируется через свойства класса DataGridViewComboBoxColumn.

13 Свойства DataGridViewComboBoxColumn Object DataSource { get; set; } Источник для заполнения списка встроенного ComboBox. Умолчание null. Список ComboBox можно задать также через свойство Items. string DisplayMember { get; set; } Имя свойства или столбца в источнике данных (связанного с ComboBox через свойство DataSource) для вывода элементов в список ComboBox. Умолчание String.Empty. string ValueMember { get; set; } Имя свойства или столбца в источнике данных, который используется как значение. Умолчание String.Empty. DataGridViewComboBoxCell. ObjectCollection.Items { get; } Значение свойства Items объекта DataGridViewComboBoxCell (доступно через свойство CellTemplate). При использовании Items значения ValueMember и DisplayMember игнорируются. bool AutoComplete { get; set; } Автоматическое заполнение списка ComboBox. Значения свойств DataSource, ValueMember и AutoComplete получают одноименные свойства объекта CellTemplate и все ячейки в столбце. При изменении значений этих свойств перерисовывается весь столбец. Чтобы изменить значения свойств только для одной ячейки, надо присвоить им значения после того, как они установлены для всего столбца.

14 Тип столбца DataGridViewButtonColumn Ячейки столбца содержат кнопки. Нельзя создать автоматически при подсоединении источника данных. Необходимо создать явно и добавить к коллекции столбцов DataGridView, которая доступна через свойство DataGridView.Columns. Удобно использовать для того, чтобы выполненить операцию с одной записью, например, для того, чтобы вывести дочернюю запись (child record) в отдельном окне. Для выполнения операции обрабатывается событие System.Windows.Forms.DataGridView.CellClick.

15 События DataGridView В классе DataGridView определено около 200 событий ( вместе с унаследованными от класса Control). Классы DataGridViewColumn, DataGridViewRow, DataGridViewCell и их производные не имеют своих событий кроме Disposed.

16 Проверка корректности данных в DataGridView Cобытие CellValidating позволяет проверить корректность введенных в ячейку данных перед тем, как они будут приняты (committed). Событие CellValidating происходит, когда изменяется текущая (current) ячейка. Событие имеет тип public delegate void DataGridViewCellValidatingEventHandler ( Object sender, DataGridViewCellValidatingEventArgs e ); В классе DataGridViewCellValidatingEventArgs определены свойства, которые можно использовать при проверке корректности введенных данных.

17 Свойства класса DataGridViewCellValidatingEventArgs bool Cancel { get; set; } true, если введенное значение не принимается. Свойство унаследовано от CancelEventArgs. Object FormattedValue { get; } Текст, введенный пользователем, передается как значение свойства FormattedValue. Это значение затем разбирается (parsed) и передается как значение свойства Value для ячейки. int ColumnIndex { get; } Номер столбца, в котором находится ячейка. int RowIndex { get; } Номер строки, в которой находится ячейка.

18 Событие DataError Событие DataError происходит, если при обновлении источника данных или при обработке событий Format или Parse возникает ошибка в данных, подсоединенных к элементу управления. Делегат события имеет тип public delegate void DataGridViewDataErrorEventHandler( Object sender, DataGridViewDataErrorEventArgs e ); Тип второго параметра делегата public class DataGridViewDataErrorEventArgs : DataGridViewCellCancelEventArgs Через свойства класса DataGridViewDataErrorEventArgs можно получить дополнительную информацию о состоянии элемента управления DataGridView при возникновении ошибки в данных.

19 Свойства класса DataGridViewDataErrorEventArgs bool Cancel { get; set; } При значении true, ячейка не отдает фокус ввода до тех пор, пока не будет введено корректное значение. Для false при некорректном вводе восстанавливается старое значение. Свойство унаследовано от CancelEventArgs. int ColumnIndex { get; } Номер столбца для ячейки DataGridViewCell, которая является источником события. Унаследовано от DataGridViewCellCancelEventArgs. int RowIndex { get; } Номер строки для ячейки DataGridViewCell, которая является источником события. Унаследовано от DataGridViewCellCancelEventArgs. Exception Exception { get; } Исключение, представляющее ошибку в данных. bool ThrowException { get; set; } true, если исключение необходимо передать другому обработчику DataGridViewDataErrorEventHandler при выходе из делегата. Умолчание false. DataGridViewDataErrorContexts Context { get; } Побитовая комбинация значений перечисления DataGridViewDataErrorContexts, уточняющая причину(контекст) ошибки.

20 Перечисление DataGridViewDataErrorContexts ЗначениеКогда произошла ошибка Formatting Форматирование данных при обмене данными между источником и элементом управления (в любом направлении). DisplayВывод(displaying ) данных, полученных из источника. PreferredSize Вычисление предпочтительного (preferred ) размера ячейки при программном изменении размера столбца или строки. RowDeletionУдаление строки в источнике, присоединенном к DataGridView. Parsing Разбор (parsing ) данных (при загрузке из источника или при вводе пользователем). Commit Фиксация (committing) изменений при передаче данных из элемента управления в подсоединенный источник. Перечисление содержит информацию о состоянии DataGridView при возникновении ошибки в данных. Перечисление имеет атрибут FlagsAttribute, допускающий побитовую комбинацию значений перечисления.

21 Перечисление DataGridViewDataErrorContexts -2 ЗначениеКогда произошла ошибка InitialValueRestoration Восстановление значения, которое имела ячейка до начала редактирования. Может встретиться, если в процессе редактирования изменилось форматирование, которое стало несовместным со старым значением. LeaveControl Элемент управления потерял фокус ввода и не может фиксировать (commit ) изменения, внесенные пользователем. CurrentCellChange Курсор выделения перешел к другой ячейке, при этом данные в предыдущей ячейке содержат ошибку. Scroll Скроллинг DataGridView (программный или пользовательский), в результате которого данные с ошибкой попали в область видимости. ClipboardContentКопирование данных в Clipboard.