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 的參考。

建構函式

名稱	Description
DataGridViewColumnCollection(DataGridView)	初始化給定DataGridView類別的新實例DataGridViewColumnCollection。

屬性

名稱	Description
Count	取得集合中元素的總數。 (繼承來源 BaseCollection)
DataGridView	取得集合執行欄位相關操作的 。DataGridView
IsReadOnly	會獲得一個值，表示該集合是否為唯讀。 (繼承來源 BaseCollection)
IsSynchronized	會取得一個值，表示存取是否 ICollection 同步。 (繼承來源 BaseCollection)
Item[Int32]	取得或將欄位設於集合中給定的索引。
Item[String]	取得或設定集合中名字的欄位。
List	取得實例中包含的 BaseCollection 元素清單。
SyncRoot	取得一個物件，可用來同步存取 BaseCollection。 (繼承來源 BaseCollection)

方法

名稱	Description
Add(DataGridViewColumn)	將給定欄位加入集合。
Add(String, String)	將 DataGridViewTextBoxColumn 欄位名稱與欄位標頭文字加入集合。
AddRange(DataGridViewColumn[])	為收藏增加一系列欄位。
Clear()	清空了收款。
Contains(DataGridViewColumn)	判斷集合是否包含該欄位。
Contains(String)	判斷集合中是否包含該名稱所指的欄位。
CopyTo(Array, Int32)	將目前一維Array中的所有元素從指定的目的Array索引開始，複製到指定的一維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)	移除集合中給定索引的欄位。

事件

名稱	Description
CollectionChanged	發生於集合變更時。

明確介面實作

名稱	Description
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