DataGridViewColumnCollection 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

表示 DataGridView 控件中 DataGridViewColumn 对象的集合。

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