DataGridViewColumnCollection DataGridViewColumnCollection DataGridViewColumnCollection DataGridViewColumnCollection Class

Определение

Представляет коллекцию объектов DataGridViewColumn в элементе управления DataGridView.Represents a collection of DataGridViewColumn objects in a DataGridView control.

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
type DataGridViewColumnCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public Class DataGridViewColumnCollection
Inherits BaseCollection
Implements IList
Наследование
DataGridViewColumnCollectionDataGridViewColumnCollectionDataGridViewColumnCollectionDataGridViewColumnCollection
Атрибуты
Реализации

Примеры

В следующем примере кода показано использование этого типа.The following code example illustrates the use of this type.

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 элемента управления.You can retrieve an instance of this class through the Columns property of the DataGridView control. Коллекция сохраняет ссылку на элемент управления через DataGridView свойство.The collection maintains a reference to the control through the DataGridView property.

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

DataGridViewColumnCollection(DataGridView) DataGridViewColumnCollection(DataGridView) DataGridViewColumnCollection(DataGridView) DataGridViewColumnCollection(DataGridView)

Инициализирует новый экземпляр класса DataGridViewColumnCollection для заданного объекта DataGridView.Initializes a new instance of the DataGridViewColumnCollection class for the given DataGridView.

Свойства

Count Count Count Count

Получает общее число элементов в коллекции.Gets the total number of elements in the collection.

(Inherited from BaseCollection)
DataGridView DataGridView DataGridView DataGridView

Получает объект DataGridView, с которым коллекция выполняет операции, относящиеся к столбцам.Gets the DataGridView upon which the collection performs column-related operations.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Возвращает значение, указывающее, является ли коллекция доступной только для чтения.Gets a value indicating whether the collection is read-only.

(Inherited from BaseCollection)
IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Возвращает значение, определяющее, синхронизирован ли доступ к интерфейсу ICollection.Gets a value indicating whether access to the ICollection is synchronized.

(Inherited from BaseCollection)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Получает или задает столбец, расположенный по заданному индексу в коллекции.Gets or sets the column at the given index in the collection.

Item[String] Item[String] Item[String] Item[String]

Получает или задает столбец в коллекции, имеющий заданное имя.Gets or sets the column of the given name in the collection.

List List List List

Получает список элементов, содержащихся в экземпляре класса BaseCollection.Gets the list of elements contained in the BaseCollection instance.

SyncRoot SyncRoot SyncRoot SyncRoot

Получает объект, с помощью которого можно синхронизировать доступ к коллекции BaseCollection.Gets an object that can be used to synchronize access to the BaseCollection.

(Inherited from BaseCollection)

Методы

Add(DataGridViewColumn) Add(DataGridViewColumn) Add(DataGridViewColumn) Add(DataGridViewColumn)

Добавляет заданный столбец в коллекцию.Adds the given column to the collection.

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

Добавляет в коллекцию объект DataGridViewTextBoxColumn с заданным именем и текстом заголовка столбца.Adds a DataGridViewTextBoxColumn with the given column name and column header text to the collection.

AddRange(DataGridViewColumn[]) AddRange(DataGridViewColumn[]) AddRange(DataGridViewColumn[]) AddRange(DataGridViewColumn[])

Добавляет диапазон столбцов в коллекцию.Adds a range of columns to the collection.

Clear() Clear() Clear() Clear()

Очищает коллекцию.Clears the collection.

Contains(DataGridViewColumn) Contains(DataGridViewColumn) Contains(DataGridViewColumn) Contains(DataGridViewColumn)

Определяет, содержит ли коллекция заданный столбец.Determines whether the collection contains the given column.

Contains(String) Contains(String) Contains(String) Contains(String)

Определяет, содержит ли коллекция столбец с заданным именем.Determines whether the collection contains the column referred to by the given name.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Копирует все элементы текущего одномерного массива Array в заданный одномерный массив Array, начиная с указанного индекса в массиве назначения Array.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(Inherited from BaseCollection)
CopyTo(DataGridViewColumn[], Int32) CopyTo(DataGridViewColumn[], Int32) CopyTo(DataGridViewColumn[], Int32) CopyTo(DataGridViewColumn[], Int32)

Копирует элементы коллекции в заданный массив.Copies the items from the collection to the given array.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetColumnCount(DataGridViewElementStates) GetColumnCount(DataGridViewElementStates) GetColumnCount(DataGridViewElementStates) GetColumnCount(DataGridViewElementStates)

Возвращает количество столбцов, отвечающих заданным требованиям фильтра.Returns the number of columns that meet the given filter requirements.

GetColumnsWidth(DataGridViewElementStates) GetColumnsWidth(DataGridViewElementStates) GetColumnsWidth(DataGridViewElementStates) GetColumnsWidth(DataGridViewElementStates)

Возвращает ширину (в пикселях), необходимую для отображения всех столбцов, отвечающих заданным требованиям фильтра.Returns the width, in pixels, required to display all of the columns that meet the given filter requirements.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Получает объект, позволяющий выполнять итерацию по элементам коллекции.Gets the object that enables iterating through the members of the collection.

(Inherited from BaseCollection)
GetFirstColumn(DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения.Returns the first column in display order that meets the given inclusion-filter requirements.

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения и фильтра исключения.Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates) GetLastColumn(DataGridViewElementStates, DataGridViewElementStates) GetLastColumn(DataGridViewElementStates, DataGridViewElementStates) GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)

Возвращает последний столбец в порядке отображения, отвечающий заданным требованиям фильтра.Returns the last column in display order that meets the given filter requirements.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates) GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates) GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates) GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)

Получает первый столбец, следующий за заданным в порядке отображения, отвечающий заданным требованиям фильтра.Gets the first column after the given column in display order that meets the given filter requirements.

GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates) GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates) GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates) GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)

Получает последний столбец, предшествующий заданному в порядке отображения и отвечающий заданным требованиям фильтра.Gets the last column prior to the given column in display order that meets the given filter requirements.

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(DataGridViewColumn) IndexOf(DataGridViewColumn) IndexOf(DataGridViewColumn) IndexOf(DataGridViewColumn)

Получает индекс заданного столбца DataGridViewColumn в коллекции.Gets the index of the given DataGridViewColumn in the collection.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Insert(Int32, DataGridViewColumn) Insert(Int32, DataGridViewColumn) Insert(Int32, DataGridViewColumn) Insert(Int32, DataGridViewColumn)

Вставляет в коллекцию столбец по указанному индексу.Inserts a column at the given index in the collection.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs) OnCollectionChanged(CollectionChangeEventArgs) OnCollectionChanged(CollectionChangeEventArgs) OnCollectionChanged(CollectionChangeEventArgs)

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

Remove(DataGridViewColumn) Remove(DataGridViewColumn) Remove(DataGridViewColumn) Remove(DataGridViewColumn)

Удаляет указанный столбец из коллекции.Removes the specified column from the collection.

Remove(String) Remove(String) Remove(String) Remove(String)

Удаляет из коллекции столбец с указанным именем.Removes the column with the specified name from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Удаляет из коллекции столбец по указанному индексу.Removes the column at the given index in the collection.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

События

CollectionChanged CollectionChanged CollectionChanged CollectionChanged

Происходит при изменении коллекции.Occurs when the collection changes.

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

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Копирует все содержимое коллекции в совместимый одномерный массив Array, начиная с указанного индекса конечного массива.Copies the entire contents of the collection to a compatible one-dimensional Array, starting at the specified index of the target array.

ICollection.Count ICollection.Count ICollection.Count ICollection.Count

Возвращает количество элементов в коллекции.Gets the number of elements in the collection.

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Возвращает значение, указывающее, является ли доступ к коллекции синхронизированным.Gets a value indicating whether access to the collection is synchronized.

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Возвращает объект, который можно использовать для синхронизации доступа к коллекции.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Возвращает перечислитель, выполняющий перебор элементов в коллекции.Returns an enumerator that iterates through the collection.

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Добавляет объект в конец коллекции.Adds an object to the end of the collection.

IList.Clear() IList.Clear() IList.Clear() IList.Clear()

Удаляет из коллекции все элементы.Removes all elements from the collection.

IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Определяет, присутствует ли объект в коллекции.Determines whether an object is in the collection.

IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Определяет индекс определенного элемента в коллекции.Determines the index of a specific item in the collection.

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Вставляет элемент в коллекцию по указанному индексу.Inserts an element into the collection at the specified index.

IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

Возвращает значение, указывающее, имеет ли коллекция фиксированный размер.Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly

Возвращает значение, указывающее, является ли коллекция доступной только для чтения.Gets a value indicating whether the collection is read-only.

IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

Возвращает или задает элемент по указанному индексу.Gets or sets the element at the specified index.

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Удаляет первое вхождение указанного объекта из коллекции.Removes the first occurrence of the specified object from the collection.

IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32)

Удаляет из коллекции элемент по указанному индексу.Removes the element with the specified index from the collection.

Методы расширения

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Преобразует IEnumerable для IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к

Дополнительно