Практическое руководство. Добавление таблиц и столбцов в элемент управления DataGrid в Windows Forms How to: Add Tables and Columns to the Windows Forms DataGrid Control

Элемент управления DataGridView заменяет элемент управления DataGrid и расширяет его функциональные возможности; однако при необходимости элемент управления DataGrid можно сохранить для обратной совместимости и использования в будущем. The DataGridView control replaces and adds functionality to the DataGrid control; however, the DataGrid control is retained for both backward compatibility and future use, if you choose. Дополнительные сведения см. в разделе Различия элементов управления DataGridView и DataGrid в Windows Forms. For more information, see Differences Between the Windows Forms DataGridView and DataGrid Controls.

Данные можно отображать в DataGrid элементах управления Windows Forms в таблицах и столбцах, создавая объекты DataGridTableStyle и добавляя их к объекту GridTableStylesCollection , доступ к которому осуществляется через DataGrid свойство TableStyles элемента управления. You can display data in the Windows Forms DataGrid control in tables and columns by creating DataGridTableStyle objects and adding them to the GridTableStylesCollection object, which is accessed through the DataGrid control’s TableStyles property. Каждый стиль таблицы отображает содержимое любой таблицы данных, указанной в свойстве MappingName объекта DataGridTableStyle . Each table style displays the contents of whatever data table is specified in the DataGridTableStyle object’s MappingName property. По умолчанию в стиле таблицы, в котором не указаны стили столбцов, отображаются все столбцы в таблице данных. By default, a table style with no column styles specified will display all the columns within that data table. Можно ограничить список отображаемых столбцов таблицы, добавив объекты DataGridColumnStyle в объект GridColumnStylesCollection , доступ к которому осуществляется через свойство GridColumnStyles каждого объекта DataGridTableStyle . You can restrict which columns from the table appear by adding DataGridColumnStyle objects to the GridColumnStylesCollection object, which is accessed through the GridColumnStyles property of each DataGridTableStyle object.

Добавление таблицы и столбца в DataGrid программным способом To add a table and column to a DataGrid programmatically

Чтобы отобразить данные в таблице, необходимо сначала привязать DataGrid элемент управления к набору данных. In order to display data in the table, you must first bind the DataGrid control to a dataset. Дополнительные сведения см. в разделе руководство. привязка Windows Forms элемента управления DataGrid к источнику данных. For more information, see How to: Bind the Windows Forms DataGrid Control to a Data Source.

При программном указании стилей столбцов всегда создавайте объекты DataGridColumnStyle и добавляйте их в объект GridColumnStylesCollection перед добавлением объектов DataGridTableStyle в объект GridTableStylesCollection . When programmatically specifying column styles, always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection object before adding DataGridTableStyle objects to the GridTableStylesCollection object. При добавлении пустого объекта DataGridTableStyle в коллекцию объекты DataGridColumnStyle создаются автоматически. When you add an empty DataGridTableStyle object to the collection, DataGridColumnStyle objects are automatically generated for you. Следовательно, при попытке добавить новые объекты DataGridColumnStyle с повторяющимися значениями MappingName в объект GridColumnStylesCollection будет создано исключение. Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection object.

Объявите новый стиль таблицы и задайте его имя сопоставления. Declare a new table style and set its mapping name.

Объявите новый стиль столбца и задайте его имя сопоставления и другие свойства. Declare a new column style and set its mapping name and other properties.

Вызовите метод Add объекта GridColumnStylesCollection , чтобы добавить столбец в стиль таблицы. Call the Add method of the GridColumnStylesCollection object to add the column to the table style

Вызовите метод Add объекта GridTableStylesCollection , чтобы добавить стиль таблицы в сетку данных. Call the Add method of the GridTableStylesCollection object to add the table style to the data grid.

Практическое руководство. Добавление таблиц и столбцов в элемент управления DataGrid в формах Windows Forms с помощью конструктора How to: Add Tables and Columns to the Windows Forms DataGrid Control Using the Designer

Элемент управления DataGridView заменяет элемент управления DataGrid и расширяет его функциональные возможности; однако при необходимости элемент управления DataGrid можно сохранить для обратной совместимости и использования в будущем. The DataGridView control replaces and adds functionality to the DataGrid control; however, the DataGrid control is retained for both backward compatibility and future use, if you choose. Дополнительные сведения см. в разделе Различия элементов управления DataGridView и DataGrid в Windows Forms. For more information, see Differences Between the Windows Forms DataGridView and DataGrid Controls.

Данные можно отображать в DataGrid элементах управления Windows Forms в таблицах и столбцах, создавая DataGridTableStyle объекты и добавляя их к GridTableStylesCollection объекту, доступ к которому осуществляется через DataGrid свойство элемента управления TableStyles . You can display data in the Windows Forms DataGrid control in tables and columns by creating DataGridTableStyle objects and adding them to the GridTableStylesCollection object, which is accessed through the DataGrid control’s TableStyles property. Каждый стиль таблицы отображает содержимое любой таблицы данных, указанной в MappingName свойстве объекта DataGridTableStyle . Each table style displays the contents of whatever data table is specified in the MappingName property of the DataGridTableStyle. По умолчанию стиль таблицы без заданных стилей столбцов будет отображать все столбцы в этой таблице данных. By default, a table style without column styles specified will display all the columns within that data table. Можно ограничить список отображаемых столбцов таблицы, добавив DataGridColumnStyle объекты в GridColumnStylesCollection коллекцию, доступ к которой осуществляется через GridColumnStyles свойство каждого из них DataGridTableStyle . You can restrict which columns from the table appear by adding DataGridColumnStyle objects to the GridColumnStylesCollection, which is accessed through the GridColumnStyles property of each DataGridTableStyle.

Для следующих процедур требуется проект приложения Windows с формой, содержащей DataGrid элемент управления. The following procedures require a Windows Application project with a form that contains a DataGrid control. Сведения о настройке такого проекта см. в статьях как создать проект приложения Windows Forms и как добавить элементы управления в Windows Forms. For information about how to set up such a project, see How to: Create a Windows Forms application project and How to: Add Controls to Windows Forms. По умолчанию в Visual Studio 2005 DataGrid элемент управления не находится на панели элементов. By default in Visual Studio 2005, the DataGrid control is not in the Toolbox. Дополнительные сведения о добавлении элементов см. в разделе как добавить элементы на панель элементов. For information about adding it, see How to: Add Items to the Toolbox.

Добавление таблицы в элемент управления DataGrid в конструкторе To add a table to the DataGrid control in the designer

Чтобы отобразить данные в таблице, необходимо сначала привязать DataGrid элемент управления к набору данных. In order to display data in the table, you must first bind the DataGrid control to a dataset. Дополнительные сведения см. в разделе руководство. привязка Windows Forms элемента управления DataGrid к источнику данных с помощью конструктора. For more information, see How to: Bind the Windows Forms DataGrid Control to a Data Source Using the Designer.

Выберите DataGrid свойство элемента управления TableStyles в окно свойств, а затем нажмите кнопку с многоточием ( ) рядом со свойством для отображения редактора коллекции DataGridTableStyle. Select the DataGrid control’s TableStyles property in the Properties window, and then click the ellipsis button ( ) next to the property to display the DataGridTableStyle Collection Editor.

В редакторе коллекции нажмите кнопку Добавить , чтобы вставить стиль таблицы. In the collection editor, click Add to insert a table style.

Нажмите кнопку ОК , чтобы закрыть редактор коллекции, а затем снова откройте его, нажав кнопку с многоточием рядом со TableStyles свойством. Click OK to close the collection editor, and then reopen it by clicking the ellipsis button next to the TableStyles property.

При повторном открытии редактора коллекции все таблицы данных, привязанные к элементу управления, будут отображаться в раскрывающемся списке для MappingName свойства стиля таблицы. When you reopen the collection editor, any data tables bound to the control will appear in the drop-down list for the MappingName property of the table style.

В поле члены редактора коллекции выберите стиль таблицы. In the Members box of the collection editor, click the table style.

В диалоговом окне Свойства редактора коллекции выберите MappingName значение для таблицы, которую необходимо отобразить. In the Properties box of the collection editor, select the MappingName value for the table you want to display.

Добавление столбца в элемент управления DataGrid в конструкторе To add a column to the DataGrid control in the designer

В поле члены редактора коллекции DataGridTableStyle выберите соответствующий стиль таблицы. In the Members box of the DataGridTableStyle Collection Editor, select the appropriate table style. В диалоговом окне Свойства редактора коллекции выберите GridColumnStyles коллекцию, а затем нажмите кнопку с многоточием ( ) рядом со свойством, чтобы отобразить Редактор коллекции DataGridColumnStyle. In the Properties box of the collection editor, select the GridColumnStyles collection, and then click the ellipsis button ( ) next to the property to display the DataGridColumnStyle Collection Editor.

В редакторе коллекции нажмите кнопку Добавить , чтобы вставить стиль столбца, или щелкните стрелку вниз рядом с пунктом Добавить , чтобы указать тип столбца. In the collection editor, click Add to insert a column style or click the down arrow next to Add to specify a column type.

В раскрывающемся списке можно выбрать DataGridTextBoxColumn DataGridBoolColumn тип или. In the drop-down box, you can select either the DataGridTextBoxColumn or DataGridBoolColumn type.

Нажмите кнопку ОК, чтобы закрыть Редактор коллекции DataGridColumnStyle, а затем снова откройте его, нажав кнопку с многоточием рядом со GridColumnStyles свойством. Click OK to close the DataGridColumnStyle Collection Editor, and then reopen it by clicking the ellipsis button next to the GridColumnStyles property.

При повторном открытии редактора коллекции все столбцы данных в связанных таблицах данных будут отображаться в раскрывающемся списке для MappingName свойства стиля столбца. When you reopen the collection editor, any data columns in the bound data table will appear in the drop-down list for the MappingName property of the column style.

В поле члены редактора коллекции щелкните стиль столбца. In the Members box of the collection editor, click the column style.

В диалоговом окне Свойства редактора коллекции выберите MappingName значение для столбца, который необходимо отобразить. In the Properties box of the collection editor, select the MappingName value for the column you want to display.

BestProg

Элемент управления dataGridView

Данная тема использует программный код из темы:

Содержание

Поиск на других ресурсах:

1. Какое назначение элемента управления DataGridView ?

В Microsoft Visual Studio элемент управления dataGridView разработан для использования в приложениях, созданных по шаблону Windows Forms Application . Данный элемент управления позволяет организовывать данные в виде таблицы. Данные могут быть получены из базы данных, коллекции, внутренних переменных — массивов или других объектов программы.

Данный элемент управления аналогичен компоненту TStringGrid в системе визуальной разработки приложений.

Данный элемент размещен на панели инструментов ToolBox во вкладках «All Windows Forms» или «Data» (рисунок 1).

После размещения на форме, система создает объект (переменную) с именем dataGridView1 . С помощью этого имени можно программно оперировать методами и свойствами этого элемента управления.

Рис. 1. Элемент управления dataGridView1 и окно Properties со свойствами

2. Можно ли использовать DataGridView непосредственно без связывания его с базой данных?

Да, можно. В DataGridView данные могут быть получены из базы данных, коллекции, внутренних структур данных (массивов, структур и т.д.).

3. Как программно задать размеры DataGridView ? Свойства Width , Height

Для задания размеров DataGridView используются свойства Width и Height .

4. Какие виды данных могут быть представлены в ячейках DataGridView ?

Виды данных, которые могут быть представлены в ячейках dataGridView :

• dataGridViewButtonColumn . Ячейки представлены в виде кнопок типа Button ;
• dataGridViewCheckBoxColumn . Ячейки представлены элементами управления типа CheckBox , которые позволяют выбирать несколько вариантов (опций) из набора предложенных;
• dataGridViewComboBoxColumn . Ячейки представлены элементами управления типа ComboBox , предназначенных для выбора одного из нескольких вариантов;
• dataGridViewImageColumn . Ячейки таблицы есть изображениями типа Image;
• dataGridViewLinkColumn . Ячейки таблицы представлены ссылками;
• dataGridViewTextBoxColumn . Этот вариант предлагается по умолчанию при добавлении (создании) нового столбца. В этом случае ячейки таблицы представлены в виде полей ввода. Это позволяет вводить данные в таблицу как в матрицу.

5. Добавление столбца программным путем

Добавить столбец в dataGridView можно:

• с помощью специального мастера;
• программным путем.

Столбцы в dataGridView организованы в виде коллекции Columns типа DataGridViewColumnCollection. Чтобы добавить столбец программным путем используется метод (команда) Add из коллекции Columns.

Метод Add имеет 2 варианта реализации:

• DataGridViewColumn – тип System.Windows.Forms.Column который добавляется;
• ColumnName – название, по которому будет осуществляться обращение к столбцу из других методов;
• HeaderText – текст, который будет отображаться в заголовке столбца.

Фрагмент кода, который добавляет два произвольных столбца следующий:

В реальных программах название столбца и его заголовка получаются из других элементов управления, например TextBox .

Для вставки столбца используется метод Insert , который имеет следующее объявление

Вызов этого метода из программного кода аналогичен методу Add .

6. Как программно реализовать удаление столбца? Методы Remove() и RemoveAt()

Чтобы удалить столбец используется один из двух методов из коллекции Columns :

• метод RemoveAt() – удаляет столбец по заданному индексу в коллекции;
• метод Remove() – удаляет столбец по его имени.

Общий вид метода RemoveAt() :

• index – заданный индекс в коллекции. Индексы нумеруются с 0.

• ColumnName – название столбца (но не название заголовка столбца), которое задается в методе Add() первым параметром. Столбцы в коллекции могут иметь одинаковые значения ColumnName . Если при вызове метода Remove() , столбца с именем ColumnName нет, то генерируется исключительная ситуация.

Фрагмент кода удаления столбца с помощью метода RemoveAt() :

7. Программное добавление строки. Метод Add()

Добавлять строку можно одним из двух способов:

• путем непосредственного ввода с клавиатуры;
• программным путем.

Строки в DataGridView организованы в виде коллекции Rows типа dataGridViewRowCollection .

Ниже приведен фрагмент метода, добавляющего 2 произвольные строки в таблицу

8. Программное удаление строки. Методы Remove() и RemoveAt()

Для удаления строки используется один из двух методов:

• метод RemoveAt() – удаляет строку по заданному индексу;
• метод Remove() – удаляет строку, которая есть входным параметром типа DataGridViewRow.

Фрагмент кода удаления строки имеет вид:

9. Задание текста заголовка в заданном столбце программным путем

Чтобы задать текст заголовка в заданном столбце используется свойство HeaderText . Фрагмент кода установки текста заголовка в столбце с индексом 0 имеет вид:

10. Установка выравнивания заголовка в заданном столбце программным путем

Выравнивание заголовка в столбце задается с помощью свойства HeaderCell.Style.Alignment .

Фрагмент кода установки выравнивания в заголовке столбца с индексом 0:

11. Установка шрифта заголовка в столбцах программным путем

Для установки шрифта в заголовках столбцов используется свойство ColumnHeadersDefaultCellStyle . В этом свойстве используется свойство Font .

Во фрагменте кода создается шрифт Arial , имеющий размер 12 и курсивное начертание.

12. Установка цвета шрифта заголовков программным путем

Чтобы задать цвет шрифта заголовков программным путем нужно использовать свойство ColumnHeaderDefaultCellStyle . В этом свойстве есть свойства ForeColor и BackColor .