Практическое руководство. Добавление таблиц и столбцов в элемент управления DataGrid в Windows Forms

Обновлен: Ноябрь 2007

Примечание.
Элемент управления DataGridView заменяет элемент управления DataGrid и расширяет его функциональные возможности; однако при необходимости элемент управления DataGrid можно сохранить для обратной совместимости и использования в будущем. Дополнительные сведения см. в разделе Различия элементов управления DataGridView и DataGrid в Windows Forms.

Данные в элементе управления Windows Forms DataGrid можно отображать в таблицах и столбцах, создавая объекты DataGridTableStyle и добавляя их в объект GridTableStylesCollection, к которому можно получить доступ через свойство TableStyles элемента управления DataGrid. Каждый стиль таблицы позволяет отображать содержимое таблицы данных, указанной в свойстве MappingName объекта DataGridTableStyle. При использовании стиля таблицы, в котором не определены стили столбцов, по умолчанию отображаются все столбцы таблицы данных. Можно ограничить число отображаемых столбцов, добавив объекты DataGridColumnStyle в объект GridColumnStylesCollection, доступ к которому можно получить с помощью свойства GridColumnStyles любого объекта DataGridTableStyle.

Чтобы добавить таблицу и столбец в элемент управления DataGrid программными средствами

1. Чтобы представить данные в таблице, необходимо сначала привязать элемент управления DataGrid к набору данных. Дополнительные сведения см. в разделе Практическое руководство. Привязка элемента управления DataGrid в Windows Forms к источнику данных.

   Внимание!

   При программном определении стилей столбцов всегда создавайте объекты DataGridColumnStyle и добавляйте их в объект GridColumnStylesCollection перед добавлением объектов DataGridTableStyle в объект GridTableStylesCollection. При добавлении в коллекцию пустого объекта DataGridTableStyle автоматически создаются объекты DataGridColumnStyle. Следовательно, при попытке добавления новых объектов DataGridColumnStyle с существующими значениями MappingName в объекте GridColumnStylesCollection возникнет исключение.

2. Объявите новый стиль таблицы и укажите для нее имя сопоставления.

   Dim ts1 As New DataGridTableStyle()
   ts1.MappingName = "Customers"
   

   DataGridTableStyle ts1 = new DataGridTableStyle();
   ts1.MappingName = "Customers";
   

   DataGridTableStyle* ts1 = new DataGridTableStyle();
   ts1->MappingName = S"Customers";
   

3. Объявите новый стиль столбца и задайте его имя сопоставления, а также другие свойства.

   Dim myDataCol As New DataGridBoolColumn()
   myDataCol.HeaderText = "My New Column"
   myDataCol.MappingName = "Current"
   

   DataGridBoolColumn myDataCol = new DataGridBoolColumn();
   myDataCol.HeaderText = "My New Column";
   myDataCol.MappingName = "Current";
   

   DataGridBoolColumn^ myDataCol = gcnew DataGridBoolColumn();
   myDataCol->HeaderText = "My New Column";
   myDataCol->MappingName = "Current";
   

4. Вызовите метод Add объекта GridColumnStylesCollection для добавления столбца в стиль таблицы.

   ts1.GridColumnStyles.Add(myDataCol)
   

   ts1.GridColumnStyles.Add(myDataCol);
   

   ts1->GridColumnStyles->Add(myDataCol);
   

5. Вызовите метод Add объекта GridTableStylesCollection для добавления стиля таблицы в сетку данных.

   DataGrid1.TableStyles.Add(ts1)
   

   dataGrid1.TableStyles.Add(ts1);
   

   dataGrid1->TableStyles->Add(ts1);
   

См. также

Задачи

Практическое руководство. Удаление или сокрытие столбцов элемента управления DataGridView в Windows Forms

Другие ресурсы

Элемент управления DataGrid (Windows Forms)