DataGridViewColumnCollection Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mewakili kumpulan DataGridViewColumn objek dalam DataGridView kontrol.

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

Warisan

Object

MarshalByRefObject

BaseCollection

DataGridViewColumnCollection

Atribut

ListBindableAttribute

Penerapan

ICollection IEnumerable IList

Contoh

Contoh kode berikut mengilustrasikan penggunaan jenis ini.

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

Keterangan

Anda dapat mengambil instans kelas ini melalui Columns properti DataGridView kontrol. Koleksi mempertahankan referensi ke kontrol melalui DataGridView properti .

Konstruktor

DataGridViewColumnCollection(DataGridView)

Menginisialisasi instans DataGridViewColumnCollection baru kelas untuk yang diberikan DataGridView.

Properti

Count	Mendapatkan jumlah total elemen dalam koleksi. (Diperoleh dari BaseCollection)
DataGridView	Mendapatkan tempat DataGridView koleksi melakukan operasi terkait kolom.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah koleksi bersifat baca-saja. (Diperoleh dari BaseCollection)
IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke disinkronkan ICollection . (Diperoleh dari BaseCollection)
Item[Int32]	Mendapatkan atau mengatur kolom pada indeks yang diberikan dalam koleksi.
Item[String]	Mendapatkan atau mengatur kolom nama yang diberikan dalam koleksi.
List	Mendapatkan daftar elemen yang terkandung dalam BaseCollection instans.
SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke BaseCollection. (Diperoleh dari BaseCollection)

Metode

Add(DataGridViewColumn)	Menambahkan kolom yang diberikan ke koleksi.
Add(String, String)	DataGridViewTextBoxColumn Menambahkan dengan nama kolom dan teks header kolom yang diberikan ke koleksi.
AddRange(DataGridViewColumn[])	Menambahkan rentang kolom ke koleksi.
Clear()	Menghapus koleksi.
Contains(DataGridViewColumn)	Menentukan apakah koleksi berisi kolom yang diberikan.
Contains(String)	Menentukan apakah koleksi berisi kolom yang dirujuk oleh nama yang diberikan.
CopyTo(Array, Int32)	Menyalin semua elemen satu dimensi Array saat ini ke satu dimensi Array yang ditentukan mulai dari indeks tujuan Array yang ditentukan. (Diperoleh dari BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Menyalin item dari koleksi ke array yang diberikan.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetColumnCount(DataGridViewElementStates)	Mengembalikan jumlah kolom yang memenuhi persyaratan filter yang diberikan.
GetColumnsWidth(DataGridViewElementStates)	Mengembalikan lebar, dalam piksel, yang diperlukan untuk menampilkan semua kolom yang memenuhi persyaratan filter yang diberikan.
GetEnumerator()	Mendapatkan objek yang memungkinkan iterasi melalui anggota koleksi. (Diperoleh dari BaseCollection)
GetFirstColumn(DataGridViewElementStates)	Mengembalikan kolom pertama dalam urutan tampilan yang memenuhi persyaratan filter inklusi yang diberikan.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Mengembalikan kolom pertama dalam urutan tampilan yang memenuhi persyaratan filter inklusi dan filter pengecualian yang diberikan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Mengembalikan kolom terakhir dalam urutan tampilan yang memenuhi persyaratan filter yang diberikan.
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Mendapatkan kolom pertama setelah kolom yang diberikan dalam urutan tampilan yang memenuhi persyaratan filter yang diberikan.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Mendapatkan kolom terakhir sebelum kolom yang diberikan dalam urutan tampilan yang memenuhi persyaratan filter yang diberikan.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IndexOf(DataGridViewColumn)	Mendapatkan indeks yang diberikan DataGridViewColumn dalam koleksi.
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
Insert(Int32, DataGridViewColumn)	Menyisipkan kolom pada indeks yang diberikan dalam koleksi.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Memunculkan kejadian CollectionChanged.
Remove(DataGridViewColumn)	Menghapus kolom yang ditentukan dari koleksi.
Remove(String)	Menghapus kolom dengan nama yang ditentukan dari koleksi.
RemoveAt(Int32)	Menghapus kolom pada indeks yang diberikan dalam koleksi.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara

CollectionChanged

Terjadi saat koleksi berubah.

Implementasi Antarmuka Eksplisit

ICollection.CopyTo(Array, Int32)	Menyalin seluruh konten koleksi ke satu dimensi Arrayyang kompatibel, dimulai pada indeks array target yang ditentukan.
ICollection.Count	Mendapatkan jumlah elemen dalam koleksi.
ICollection.IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke koleksi disinkronkan.
ICollection.SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke koleksi.
IEnumerable.GetEnumerator()	Mengembalikan enumerator yang melakukan iterasi melalui koleksi.
IList.Add(Object)	Menambahkan objek ke akhir koleksi.
IList.Clear()	Menghapus semua elemen dari koleksi.
IList.Contains(Object)	Menentukan apakah objek berada dalam koleksi.
IList.IndexOf(Object)	Menentukan indeks item tertentu dalam koleksi.
IList.Insert(Int32, Object)	Menyisipkan elemen ke dalam koleksi pada indeks yang ditentukan.
IList.IsFixedSize	Mendapatkan nilai yang menunjukkan apakah koleksi memiliki ukuran tetap.
IList.IsReadOnly	Mendapatkan nilai yang menunjukkan apakah koleksi bersifat baca-saja.
IList.Item[Int32]	Mendapatkan atau mengatur elemen pada indeks yang ditentukan.
IList.Remove(Object)	Menghapus kemunculan pertama objek yang ditentukan dari koleksi.
IList.RemoveAt(Int32)	Menghapus elemen dengan indeks yang ditentukan dari koleksi.

Metode Ekstensi

Lihat juga

• DataGridView
• Columns
• DataGridViewColumn