DataGridViewColumnCollection Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt eine Auflistung von DataGridViewColumn-Objekten in einem DataGridView-Steuerelement dar.

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

Vererbung

Object

MarshalByRefObject

BaseCollection

DataGridViewColumnCollection

Attribute

ListBindableAttribute

Implementiert

ICollection IEnumerable IList

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht.

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

Hinweise

Sie können eine instance dieser Klasse über die Columns -Eigenschaft des -Steuerelements DataGridView abrufen. Die Auflistung verwaltet über die -Eigenschaft einen Verweis auf das DataGridView -Steuerelement.

Konstruktoren

DataGridViewColumnCollection(DataGridView)

Initialisiert eine neue Instanz der DataGridViewColumnCollection-Klasse für die angegebene DataGridView.

Eigenschaften

Count	Ruft die Gesamtanzahl der in der Auflistung enthaltenen Elemente ab. (Geerbt von BaseCollection)
DataGridView	Ruft die DataGridView ab, für die die Auflistung Spaltenvorgänge ausführt.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist. (Geerbt von BaseCollection)
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert ist. (Geerbt von BaseCollection)
Item[Int32]	Ruft die Spalte am angegebenen Index in der Auflistung ab oder legt diese fest.
Item[String]	Ruft die Spalte mit dem angegebenen Namen in der Auflistung ab oder legt diese fest.
List	Ruft die Liste der in der BaseCollection-Instanz enthaltenen Elemente ab.
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf BaseCollection synchronisiert werden kann. (Geerbt von BaseCollection)

Methoden

Add(DataGridViewColumn)	Fügt der Auflistung die angegebene Spalte hinzu.
Add(String, String)	Fügt der Auflistung eine DataGridViewTextBoxColumn mit dem angegebenen Spaltennamen und Spaltenheadertext hinzu.
AddRange(DataGridViewColumn[])	Fügt der Auflistung einen Spaltenbereich hinzu.
Clear()	Löscht die Auflistung.
Contains(DataGridViewColumn)	Bestimmt, ob sich die angegebene Spalte in der Auflistung befindet.
Contains(String)	Bestimmt, ob die Auflistung die Spalte enthält, auf die mit dem angegebenen Namen verwiesen wird.
CopyTo(Array, Int32)	Kopiert alle Elemente des aktuellen eindimensionalen Array in das angegebene eindimensionale Array, beginnend am angegebenen Index des Ziel-Array. (Geerbt von BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Kopiert die Elemente aus der Auflistung in das angegebene Array.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetColumnCount(DataGridViewElementStates)	Gibt die Anzahl von Spalten zurück, die den angegebenen Filteranforderungen entsprechen.
GetColumnsWidth(DataGridViewElementStates)	Gibt die Breite (in Pixel) zurück, die für die Anzeige aller Spalten benötigt wird, die den angegebenen Filteranforderungen entsprechen.
GetEnumerator()	Ruft das Objekt ab, mit dem die Member der Auflistung durchlaufen werden können. (Geerbt von BaseCollection)
GetFirstColumn(DataGridViewElementStates)	Gibt die erste Spalte in der Anzeigereihenfolge zurück, die den angegebenen Inklusionsfilteranforderungen entspricht.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Gibt die erste Spalte in der Anzeigereihenfolge zurück, die den angegebenen In- und Exklusionsfilteranforderungen entspricht.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Gibt die letzte Spalte in der Anzeigereihenfolge zurück, die den angegebenen Filteranforderungen entspricht.
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Ruft die erste Spalte nach der angegebenen Spalte in der Anzeigereihenfolge ab, die den angegebenen Filteranforderungen entspricht.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Ruft die letzte Spalte vor der angegebenen Spalte in der Anzeigereihenfolge ab, die den angegebenen Filteranforderungen entspricht.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(DataGridViewColumn)	Ruft den Index der angegebenen DataGridViewColumn in der Auflistung ab.
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
Insert(Int32, DataGridViewColumn)	Fügt am angegebenen Index eine Spalte in die Auflistung ein.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Löst das CollectionChanged-Ereignis aus.
Remove(DataGridViewColumn)	Entfernt die angegebene Spalte aus der Auflistung.
Remove(String)	Entfernt die Spalte mit dem angegebenen Namen aus der Auflistung.
RemoveAt(Int32)	Entfernt die Spalte am angegebenen Index aus der Auflistung.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

CollectionChanged

Tritt auf, wenn die Auflistung sich ändert.

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Kopiert den gesamten Inhalt der Auflistung in ein kompatibles eindimensionales Array, beginnend ab dem angegebenen Index des Zielarrays.
ICollection.Count	Ruft die Anzahl der Elemente in der Auflistung ab.
ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert ist.
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die Auflistung synchronisiert werden kann.
IEnumerable.GetEnumerator()	Gibt einen Enumerator zurück, der die Auflistung durchläuft.
IList.Add(Object)	Fügt ein Objekt am Ende der Auflistung hinzu.
IList.Clear()	Entfernt alle Elemente aus der Auflistung.
IList.Contains(Object)	Bestimmt, ob sich ein Objekt in der Auflistung befindet.
IList.IndexOf(Object)	Bestimmt den Index eines bestimmten Elements in der Auflistung.
IList.Insert(Int32, Object)	Fügt ein Element am angegebenen Index in die Auflistung ein.
IList.IsFixedSize	Ruft einen Wert ab, der angibt, ob die Auflistung eine feste Größe aufweist.
IList.IsReadOnly	Ruft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.
IList.Item[Int32]	Ruft das Element am angegebenen Index ab oder legt dieses fest.
IList.Remove(Object)	Entfernt das erste Vorkommen des angegebenen Objekts aus der Auflistung.
IList.RemoveAt(Int32)	Entfernt das Element mit dem angegebenen Index aus der Auflistung.

Erweiterungsmethoden

Weitere Informationen

• DataGridView
• Columns
• DataGridViewColumn