DataGridViewColumnCollection Класс

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Представляет коллекцию объектов 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)	Копирует все элементы текущего одномерного массива Array в заданный одномерный массив Array, начиная с указанного индекса в массиве назначения Array. (Унаследовано от BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Копирует элементы коллекции в заданный массив.
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetColumnCount(DataGridViewElementStates)	Возвращает количество столбцов, отвечающих заданным требованиям фильтра.
GetColumnsWidth(DataGridViewElementStates)	Возвращает ширину (в пикселях), необходимую для отображения всех столбцов, отвечающих заданным требованиям фильтра.
GetEnumerator()	Получает объект, позволяющий выполнять итерацию по элементам коллекции. (Унаследовано от BaseCollection)
GetFirstColumn(DataGridViewElementStates)	Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения и фильтра исключения.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Возвращает последний столбец в порядке отображения, отвечающий заданным требованиям фильтра.
GetLifetimeService()	Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Получает первый столбец, следующий за заданным в порядке отображения, отвечающий заданным требованиям фильтра.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Получает последний столбец, предшествующий заданному в порядке отображения и отвечающий заданным требованиям фильтра.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IndexOf(DataGridViewColumn)	Получает индекс заданного столбца DataGridViewColumn в коллекции.
InitializeLifetimeService()	Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
Insert(Int32, DataGridViewColumn)	Вставляет в коллекцию столбец по указанному индексу.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Вызывает событие CollectionChanged.
Remove(DataGridViewColumn)	Удаляет указанный столбец из коллекции.
Remove(String)	Удаляет из коллекции столбец с указанным именем.
RemoveAt(Int32)	Удаляет из коллекции столбец по указанному индексу.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

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