DataGridViewColumnCollection Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewColumnCollection.cs

Представляет коллекцию DataGridViewColumn объектов в элементе DataGridView управления.

public ref class DataGridViewColumnCollection : System::Windows::Forms::BaseCollection, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class DataGridViewColumnCollection : System.Windows.Forms.BaseCollection, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type DataGridViewColumnCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable

Public Class DataGridViewColumnCollection
Inherits BaseCollection
Implements IList

Наследование

Object

MarshalByRefObject

BaseCollection

DataGridViewColumnCollection

Атрибуты

ListBindableAttribute

Реализации

ICollection IEnumerable IList

Примеры

В следующем примере кода показано использование этого типа.

private DataGridView dataGridView1 = new DataGridView();

private void AddColorColumn()
{
    DataGridViewComboBoxColumn comboBoxColumn =
        new DataGridViewComboBoxColumn();
    comboBoxColumn.Items.AddRange(
        Color.Red, Color.Yellow, Color.Green, Color.Blue);
    comboBoxColumn.ValueType = typeof(Color);
    dataGridView1.Columns.Add(comboBoxColumn);
    dataGridView1.EditingControlShowing +=
        new DataGridViewEditingControlShowingEventHandler(
        dataGridView1_EditingControlShowing);
}

private void dataGridView1_EditingControlShowing(object sender,
    DataGridViewEditingControlShowingEventArgs e)
{
    ComboBox combo = e.Control as ComboBox;
    if (combo != null)
    {
        // Remove an existing event-handler, if present, to avoid 
        // adding multiple handlers when the editing control is reused.
        combo.SelectedIndexChanged -=
            new EventHandler(ComboBox_SelectedIndexChanged);

        // Add the event handler. 
        combo.SelectedIndexChanged +=
            new EventHandler(ComboBox_SelectedIndexChanged);
    }
}

private void ComboBox_SelectedIndexChanged(object sender, EventArgs e)
{
    ((ComboBox)sender).BackColor = (Color)((ComboBox)sender).SelectedItem;
}

Private WithEvents dataGridView1 As New DataGridView()

Private Sub AddColorColumn()

    Dim comboBoxColumn As New DataGridViewComboBoxColumn()
    comboBoxColumn.Items.AddRange( _
        Color.Red, Color.Yellow, Color.Green, Color.Blue)
    comboBoxColumn.ValueType = GetType(Color)
    dataGridView1.Columns.Add(comboBoxColumn)

End Sub

Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
    ByVal e As DataGridViewEditingControlShowingEventArgs) _
    Handles dataGridView1.EditingControlShowing

    Dim combo As ComboBox = CType(e.Control, ComboBox)
    If (combo IsNot Nothing) Then

        ' Remove an existing event-handler, if present, to avoid 
        ' adding multiple handlers when the editing control is reused.
        RemoveHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

        ' Add the event handler. 
        AddHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

    End If

End Sub

Private Sub ComboBox_SelectedIndexChanged( _
    ByVal sender As Object, ByVal e As EventArgs)

    Dim comboBox1 As ComboBox = CType(sender, ComboBox)
    comboBox1.BackColor = _
        CType(CType(sender, ComboBox).SelectedItem, Color)

End Sub

Комментарии

Экземпляр этого класса можно получить с помощью Columns свойства DataGridView элемента управления. Коллекция сохраняет ссылку на элемент управления через DataGridView свойство.

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

Имя	Описание
DataGridViewColumnCollection(DataGridView)	Инициализирует новый экземпляр DataGridViewColumnCollection класса для заданного DataGridView.

Свойства

Имя	Описание
Count	Возвращает общее количество элементов в коллекции. (Унаследовано от BaseCollection)
DataGridView	Возвращает значение, DataGridView на котором коллекция выполняет операции, связанные с столбцами.
IsReadOnly	Возвращает значение, указывающее, доступна ли коллекция только для чтения. (Унаследовано от BaseCollection)
IsSynchronized	Возвращает значение, указывающее, синхронизирован ли доступ к ней ICollection . (Унаследовано от BaseCollection)
Item[Int32]	Возвращает или задает столбец по заданному индексу в коллекции.
Item[String]	Возвращает или задает столбец заданного имени в коллекции.
List	Возвращает список элементов, содержащихся в экземпляре BaseCollection .
SyncRoot	Получает объект, который можно использовать для синхронизации доступа к объекту BaseCollection. (Унаследовано от BaseCollection)

Методы

Имя	Описание
Add(DataGridViewColumn)	Добавляет заданный столбец в коллекцию.
Add(String, String)	Добавляет в коллекцию заданное DataGridViewTextBoxColumn имя столбца и текст заголовка столбца.
AddRange(DataGridViewColumn[])	Добавляет в коллекцию диапазон столбцов.
Clear()	Очищает коллекцию.
Contains(DataGridViewColumn)	Определяет, содержит ли коллекция заданный столбец.
Contains(String)	Определяет, содержит ли коллекция столбец, на который ссылается заданное имя.
CopyTo(Array, Int32)	Копирует все элементы текущего одномерного в указанный одномерный ArrayArray индекс, начиная с указанного целевого Array индекса. (Унаследовано от BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Копирует элементы из коллекции в заданный массив.
GetColumnCount(DataGridViewElementStates)	Возвращает количество столбцов, удовлетворяющих заданным требованиям фильтра.
GetColumnsWidth(DataGridViewElementStates)	Возвращает ширину (в пикселях), необходимую для отображения всех столбцов, удовлетворяющих заданным требованиям фильтра.
GetEnumerator()	Возвращает объект, который позволяет выполнять итерацию между элементами коллекции. (Унаследовано от BaseCollection)
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Возвращает первый столбец в порядке отображения, который соответствует заданным требованиям фильтра включения и исключения.
GetFirstColumn(DataGridViewElementStates)	Возвращает первый столбец в порядке отображения, который соответствует заданным требованиям фильтра включения.
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Возвращает последний столбец в порядке отображения, который соответствует заданным требованиям фильтра.
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Возвращает первый столбец после заданного столбца в порядке отображения, соответствующего заданным требованиям фильтра.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Получает последний столбец до заданного столбца в порядке отображения, который соответствует заданным требованиям фильтра.
IndexOf(DataGridViewColumn)	Возвращает индекс заданного DataGridViewColumn в коллекции.
Insert(Int32, DataGridViewColumn)	Вставляет столбец по указанному индексу в коллекцию.
OnCollectionChanged(CollectionChangeEventArgs)	Вызывает событие CollectionChanged.
Remove(DataGridViewColumn)	Удаляет указанный столбец из коллекции.
Remove(String)	Удаляет столбец с указанным именем из коллекции.
RemoveAt(Int32)	Удаляет столбец по указанному индексу в коллекции.

События

Имя	Описание
CollectionChanged	Происходит при изменении коллекции.

Явные реализации интерфейса

Имя	Описание
ICollection.CopyTo(Array, Int32)	Копирует все содержимое коллекции в совместимое одномерное Array, начиная с указанного индекса целевого массива.
ICollection.Count	Возвращает количество элементов в коллекции.
ICollection.IsSynchronized	Возвращает значение, указывающее, синхронизирован ли доступ к коллекции.
ICollection.SyncRoot	Возвращает объект, который можно использовать для синхронизации доступа к коллекции.
IEnumerable.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по коллекции.
IList.Add(Object)	Добавляет объект в конец коллекции.
IList.Clear()	Удаляет все элементы из коллекции.
IList.Contains(Object)	Определяет, находится ли объект в коллекции.
IList.IndexOf(Object)	Определяет индекс определенного элемента в коллекции.
IList.Insert(Int32, Object)	Вставляет элемент в коллекцию по указанному индексу.
IList.IsFixedSize	Возвращает значение, указывающее, имеет ли коллекция фиксированный размер.
IList.IsReadOnly	Возвращает значение, указывающее, доступна ли коллекция только для чтения.
IList.Item[Int32]	Возвращает или задает элемент по указанному индексу.
IList.Remove(Object)	Удаляет первое вхождение указанного объекта из коллекции.
IList.RemoveAt(Int32)	Удаляет элемент с указанным индексом из коллекции.

См. также раздел

• DataGridView
• Columns
• DataGridViewColumn