DataGridViewColumnCollection Класс

Определение

Представляет коллекцию объектов 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
Наследование
DataGridViewColumnCollection
Атрибуты
Реализации

Примеры

В следующем примере кода показано использование этого типа.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.Initializes a new instance of the DataGridViewColumnCollection class for the given DataGridView.

Свойства

Count

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

(Унаследовано от BaseCollection)
DataGridView

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

IsReadOnly

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

(Унаследовано от BaseCollection)
IsSynchronized

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

(Унаследовано от BaseCollection)
Item[Int32]

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

Item[String]

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

List

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

SyncRoot

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

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

Методы

Add(DataGridViewColumn)

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

Add(String, String)

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

AddRange(DataGridViewColumn[])

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

Clear()

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

Contains(DataGridViewColumn)

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

Contains(String)

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

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.

(Унаследовано от BaseCollection)
CopyTo(DataGridViewColumn[], Int32)

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

CreateObjRef(Type)

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

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

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

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

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

GetColumnsWidth(DataGridViewElementStates)

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

GetEnumerator()

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

(Унаследовано от BaseCollection)
GetFirstColumn(DataGridViewElementStates)

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

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

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

GetHashCode()

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

(Унаследовано от Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)

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

GetLifetimeService()

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

(Унаследовано от MarshalByRefObject)
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)

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

GetType()

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

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

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

InitializeLifetimeService()

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

(Унаследовано от MarshalByRefObject)
Insert(Int32, DataGridViewColumn)

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

MemberwiseClone()

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

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

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

(Унаследовано от MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

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

Remove(DataGridViewColumn)

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

Remove(String)

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

RemoveAt(Int32)

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

ToString()

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

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

События

CollectionChanged

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

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

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

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

ICollection.IsSynchronized

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

ICollection.SyncRoot

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

IEnumerable.GetEnumerator()

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

IList.Add(Object)

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

IList.Clear()

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

IList.Contains(Object)

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

IList.IndexOf(Object)

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

IList.Insert(Int32, Object)

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

IList.IsFixedSize

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

IList.IsReadOnly

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

IList.Item[Int32]

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

IList.Remove(Object)

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

IList.RemoveAt(Int32)

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

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

Cast<TResult>(IEnumerable)

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

OfType<TResult>(IEnumerable)

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

AsParallel(IEnumerable)

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

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

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

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