DataGridViewColumnCollection Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Reprezentuje kolekcję DataGridViewColumn obiektów w kontrolce 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

Dziedziczenie

Object

MarshalByRefObject

BaseCollection

DataGridViewColumnCollection

Atrybuty

ListBindableAttribute

Implementuje

ICollection IEnumerable IList

Przykłady

Poniższy przykład kodu ilustruje użycie tego typu.

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

Uwagi

Wystąpienie tej klasy można pobrać za pomocą Columns właściwości kontrolki DataGridView . Kolekcja przechowuje odwołanie do kontrolki za pośrednictwem DataGridView właściwości .

Konstruktory

DataGridViewColumnCollection(DataGridView)

Inicjuje DataGridViewColumnCollection nowe wystąpienie klasy dla danej DataGridViewklasy .

Właściwości

Count	Pobiera całkowitą liczbę elementów w kolekcji. (Odziedziczone po BaseCollection)
DataGridView	Pobiera element DataGridView , na którym kolekcja wykonuje operacje związane z kolumną.
IsReadOnly	Pobiera wartość wskazującą, czy kolekcja jest przeznaczona tylko do odczytu. (Odziedziczone po BaseCollection)
IsSynchronized	Pobiera wartość wskazującą, czy dostęp do pliku ICollection jest synchronizowany. (Odziedziczone po BaseCollection)
Item[Int32]	Pobiera lub ustawia kolumnę w danym indeksie w kolekcji.
Item[String]	Pobiera lub ustawia kolumnę podanej nazwy w kolekcji.
List	Pobiera listę elementów zawartych w wystąpieniu BaseCollection .
SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do obiektu BaseCollection. (Odziedziczone po BaseCollection)

Metody

Add(DataGridViewColumn)	Dodaje daną kolumnę do kolekcji.
Add(String, String)	Dodaje element DataGridViewTextBoxColumn z podaną nazwą kolumny i tekstem nagłówka kolumny do kolekcji.
AddRange(DataGridViewColumn[])	Dodaje zakres kolumn do kolekcji.
Clear()	Czyści kolekcję.
Contains(DataGridViewColumn)	Określa, czy kolekcja zawiera daną kolumnę.
Contains(String)	Określa, czy kolekcja zawiera kolumnę, do której odwołuje się dana nazwa.
CopyTo(Array, Int32)	Kopiuje wszystkie elementy bieżącego jednowymiarowego do określonego jednowymiarowego ArrayArray indeksu rozpoczynającego się od określonego indeksu docelowego Array . (Odziedziczone po BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Kopiuje elementy z kolekcji do danej tablicy.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetColumnCount(DataGridViewElementStates)	Zwraca liczbę kolumn spełniających podane wymagania filtru.
GetColumnsWidth(DataGridViewElementStates)	Zwraca szerokość (w pikselach) wymaganą do wyświetlenia wszystkich kolumn spełniających podane wymagania filtru.
GetEnumerator()	Pobiera obiekt, który umożliwia iterowanie za pośrednictwem elementów członkowskich kolekcji. (Odziedziczone po BaseCollection)
GetFirstColumn(DataGridViewElementStates)	Zwraca pierwszą kolumnę w kolejności wyświetlania, która spełnia podane wymagania dotyczące filtru dołączania.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Zwraca pierwszą kolumnę w kolejności wyświetlania, która spełnia podane wymagania dotyczące filtru dołączania i filtrowania wykluczeń.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Zwraca ostatnią kolumnę w kolejności wyświetlania, która spełnia podane wymagania dotyczące filtru.
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Pobiera pierwszą kolumnę po podanej kolumnie w kolejności wyświetlania, która spełnia podane wymagania filtru.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Pobiera ostatnią kolumnę przed daną kolumną w kolejności wyświetlania, która spełnia podane wymagania filtru.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IndexOf(DataGridViewColumn)	Pobiera indeks danej DataGridViewColumn wartości w kolekcji.
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
Insert(Int32, DataGridViewColumn)	Wstawia kolumnę w danym indeksie w kolekcji.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	CollectionChanged Zgłasza zdarzenie.
Remove(DataGridViewColumn)	Usuwa określoną kolumnę z kolekcji.
Remove(String)	Usuwa kolumnę o określonej nazwie z kolekcji.
RemoveAt(Int32)	Usuwa kolumnę w danym indeksie w kolekcji.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

CollectionChanged

Występuje, gdy kolekcja ulegnie zmianie.

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)	Kopiuje całą zawartość kolekcji do zgodnej jednowymiarowej Array, począwszy od określonego indeksu tablicy docelowej.
ICollection.Count	Pobiera liczbę elementów w kolekcji.
ICollection.IsSynchronized	Pobiera wartość wskazującą, czy dostęp do kolekcji jest synchronizowany.
ICollection.SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do kolekcji.
IEnumerable.GetEnumerator()	Zwraca moduł wyliczający, który iteruje po kolekcji.
IList.Add(Object)	Dodaje obiekt na końcu kolekcji.
IList.Clear()	Usuwa wszystkie elementy z kolekcji.
IList.Contains(Object)	Określa, czy obiekt znajduje się w kolekcji.
IList.IndexOf(Object)	Określa indeks określonego elementu w kolekcji.
IList.Insert(Int32, Object)	Wstawia element do kolekcji w określonym indeksie.
IList.IsFixedSize	Pobiera wartość wskazującą, czy kolekcja ma stały rozmiar.
IList.IsReadOnly	Pobiera wartość wskazującą, czy kolekcja jest przeznaczona tylko do odczytu.
IList.Item[Int32]	Pobiera lub ustawia element pod określonym indeksem.
IList.Remove(Object)	Usuwa pierwsze wystąpienie określonego obiektu z kolekcji.
IList.RemoveAt(Int32)	Usuwa element z określonym indeksem z kolekcji.

Metody rozszerzania

Zobacz też

• DataGridView
• Columns
• DataGridViewColumn