Data Grid View Column Класс

Определение

Представляет столбец в элементе управления DataGridView. Represents a column in a DataGridView control.

Примеры

В следующем примере кода создается форма Windows с DataGridView набором кнопок и. The following code example creates a Windows Form with a DataGridView and a set of buttons. Каждая метка кнопки описывает операцию, связанную со DataGridViewColumn свойством, например переключение первого и последнего столбца (с помощью DisplayIndex Свойства) или изменение текста заголовка столбца (с помощью HeaderText Свойства). Each button label describes an operation related to a DataGridViewColumn property, such as swapping the first and last column (using the DisplayIndex property) or changing the text of a column header (using the HeaderText property). При нажатии кнопки изменяется связанное свойство объекта DataGridViewColumn . Clicking a button changes the associated property of the DataGridViewColumn.

Комментарии

DataGridViewColumnКласс представляет логический столбец в DataGridView элементе управления. The DataGridViewColumn class represents a logical column in a DataGridView control. Столбцы можно получить через Columns коллекцию элемента управления. You can retrieve columns through the Columns collection of the control.

В отличие от DataGridViewRow , который содержит фактическую коллекцию ячеек в, в DataGridView DataGridViewColumn основном используется для настройки внешнего вида и поведения пользовательского интерфейса столбца, например ширины столбца и стиля ячейки. Unlike a DataGridViewRow, which contains the actual collection of cells in a DataGridView, DataGridViewColumn is used mainly to adjust the appearance and behavior of the column user interface (UI), such as column width and cell style. Дополнительные сведения о стилях ячеек см. в разделе Стили ячеек в элементе управления Windows Forms DataGridView. For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control.

Типы, производные от, DataGridViewColumn обычно инициализируют CellTemplate свойство новым экземпляром связанного типа, производного от DataGridViewCell класса. Types that derive from DataGridViewColumn typically initialize the CellTemplate property to a new instance of a related type derived from the DataGridViewCell class. Все свойства столбцов, связанные с внешним видом или поведением отдельных ячеек, являются оболочками для соответствующих свойств ячейки шаблона. Any column properties that relate to the appearance or behavior of individual cells are wrappers for the corresponding properties of the template cell. При изменении одного из этих свойств в столбце автоматически изменяется значение шаблона ячейки и для всех ячеек в столбце. Changing one of these properties on the column automatically changes the value on the cell template and on all cells in the column. Чтобы переопределить указанное значение для отдельных ячеек, задайте значения ячеек после установки значения столбца. To override the specified value for individual cells, set the cell values after you set the column value.

Примечания для тех, кто наследует этот метод

При наследовании от DataGridViewColumn и добавлении новых свойств в производный класс обязательно Переопределите Clone() метод, чтобы скопировать новые свойства во время операций клонирования. When you derive from DataGridViewColumn and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. Также следует вызвать метод базового класса, Clone() чтобы свойства базового класса копировались в новую ячейку. You should also call the base class’s Clone() method so that the properties of the base class are copied to the new cell.

Конструкторы

Инициализирует новый экземпляр класса DataGridViewColumn, устанавливая его в состояние по умолчанию. Initializes a new instance of the DataGridViewColumn class to the default state.

Инициализирует новый экземпляр класса DataGridViewColumn, используя существующий объект DataGridViewCell как шаблон. Initializes a new instance of the DataGridViewColumn class using an existing DataGridViewCell as a template.

Свойства

Возвращает или задает режим, в котором автоматически изменяется ширина столбца. Gets or sets the mode by which the column automatically adjusts its width.

Возвращает или задает шаблон, используемый для создания ячеек. Gets or sets the template used to create new cells.

Возвращает тип времени выполнения шаблона ячеек. Gets the run-time type of the cell template.

Возвращает или задает контекстное меню для столбца. Gets or sets the shortcut menu for the column.

Получает элемент управления DataGridView, связанный с данным элементом. Gets the DataGridView control associated with this element.

(Унаследовано от DataGridViewElement) DataPropertyName

Возвращает или задает имя того свойства данных или столбца базы данных в источнике данных, с которым связан столбец DataGridViewColumn. Gets or sets the name of the data source property or database column to which the DataGridViewColumn is bound.

Возвращает или задает стиль по умолчанию для ячеек столбца. Gets or sets the column’s default cell style.

Получает или задает тип времени выполнения для ячейки заголовка по умолчанию. Gets or sets the run-time type of the default header cell.

(Унаследовано от DataGridViewBand) Displayed

Получает значение, показывающее, отображается ли диапазон на экране в данный момент. Gets a value indicating whether the band is currently displayed onscreen.

(Унаследовано от DataGridViewBand) DisplayIndex

Возвращает или задает расположение столбца относительно столбцов, отображаемых в текущий момент. Gets or sets the display order of the column relative to the currently displayed columns.

Возвращает или задает ширину (в пикселях) разделителя столбца. Gets or sets the width, in pixels, of the column divider.

Возвращает или задает значение, представляющее ширину столбца, находящегося в режиме заполнения, относительно ширины других столбцов элемента управления, находящихся в этом режиме. Gets or sets a value that represents the width of the column when it is in fill mode relative to the widths of other fill-mode columns in the control.

Возвращает или задает значение, указывающее, перемещается ли столбец, когда пользователь выполняет горизонтальную прокрутку элемента управления DataGridView. Gets or sets a value indicating whether a column will move when a user scrolls the DataGridView control horizontally.

Получает значение, показывающее, было ли установлено свойство DefaultCellStyle. Gets a value indicating whether the DefaultCellStyle property has been set.

(Унаследовано от DataGridViewBand) HeaderCell

Возвращает или задает объект DataGridViewColumnHeaderCell, представляющий заголовок столбца. Gets or sets the DataGridViewColumnHeaderCell that represents the column header.

Получает или задает ячейку заголовка объекта DataGridViewBand. Gets or sets the header cell of the DataGridViewBand.

(Унаследовано от DataGridViewBand) HeaderText

Возвращает или задает текст ячейки заголовка столбца. Gets or sets the caption text on the column’s header cell.

Получает относительную позицию диапазона в элементе управления DataGridView. Gets the relative position of the band within the DataGridView control.

(Унаследовано от DataGridViewBand) InheritedAutoSizeMode

Возвращает или задает режим изменения размера, действующий для столбца. Gets the sizing mode in effect for the column.

Возвращает стиль ячейки, применяемый в текущий момент к столбцу. Gets the cell style currently applied to the column.

Возвращает значение, указывающее, связан ли столбец с источником данных. Gets a value indicating whether the column is bound to a data source.

Получает значение, показывающее, представляет ли диапазон строку. Gets a value indicating whether the band represents a row.

(Унаследовано от DataGridViewBand) MinimumWidth

Возвращает или задает наименьшую ширину столбца (в пикселях). Gets or sets the minimum width, in pixels, of the column.

Возвращает или задает имя столбца. Gets or sets the name of the column.

Возвращает или задает значение, указывающее, может ли пользователь изменять ячейки столбца. Gets or sets a value indicating whether the user can edit the column’s cells.

Возвращает или задает значение, указывающее, возможно ли изменение размера столбца. Gets or sets a value indicating whether the column is resizable.

Получает или задает значение, показывающее, выделен ли диапазон в пользовательском интерфейсе. Gets or sets a value indicating whether the band is in a selected user interface (UI) state.

(Унаследовано от DataGridViewBand) Site

Возвращает или задает подложку столбца. Gets or sets the site of the column.

Возвращает или задает режим сортировки для столбца. Gets or sets the sort mode for the column.

Получает состояние пользовательского интерфейса для элемента. Gets the user interface (UI) state of the element.

(Унаследовано от DataGridViewElement) Tag

Получает или задает объект, содержащий данные, связанные с диапазоном. Gets or sets the object that contains data to associate with the band.

(Унаследовано от DataGridViewBand) ToolTipText

Возвращает или задает текст, используемый для подсказок. Gets or sets the text used for ToolTips.

Возвращает или задает тип данных для значений в ячейках столбца. Gets or sets the data type of the values in the column’s cells.

Возвращает или задает значение, показывающее, видим ли столбец. Gets or sets a value indicating whether the column is visible.

Возвращает или задает текущую ширину столбца. Gets or sets the current width of the column.

Методы

Создает точную копию данного диапазона. Creates an exact copy of this band.

Освобождает все ресурсы, занятые модулем DataGridViewBand. Releases all resources used by the DataGridViewBand.

(Унаследовано от DataGridViewBand) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом DataGridViewBand, а при необходимости освобождает также управляемые ресурсы. Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

Определяет, равен ли указанный объект текущему объекту. Determines whether the specified object is equal to the current object.

(Унаследовано от Object) GetHashCode()

Служит хэш-функцией по умолчанию. Serves as the default hash function.

(Унаследовано от Object) GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

Вычисляет оптимальную ширину столбца на основе указанных критериев. Calculates the ideal width of the column based on the specified criteria.

Возвращает объект Type для текущего экземпляра. Gets the Type of the current instance.

(Унаследовано от Object) MemberwiseClone()

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

(Унаследовано от Object) OnDataGridViewChanged()

Вызывается, когда диапазон связан с другим элементом управления DataGridView. Called when the band is associated with a different DataGridView.

(Унаследовано от DataGridViewBand) RaiseCellClick(DataGridViewCellEventArgs)

Вызывает событие CellClick. Raises the CellClick event.

(Унаследовано от DataGridViewElement) RaiseCellContentClick(DataGridViewCellEventArgs)

Вызывает событие CellContentClick. Raises the CellContentClick event.

(Унаследовано от DataGridViewElement) RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

(Унаследовано от DataGridViewElement) RaiseCellValueChanged(DataGridViewCellEventArgs)

Вызывает событие CellValueChanged. Raises the CellValueChanged event.

(Унаследовано от DataGridViewElement) RaiseDataError(DataGridViewDataErrorEventArgs)

Вызывает событие DataError. Raises the DataError event.

(Унаследовано от DataGridViewElement) RaiseMouseWheel(MouseEventArgs)

Вызывает событие MouseWheel. Raises the MouseWheel event.

(Унаследовано от DataGridViewElement) ToString()

Возвращает строку, описывающую столбец. Gets a string that describes the column.

События

Происходит при удалении объекта DataGridViewColumn. Occurs when the DataGridViewColumn is disposed.

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 .