DataGridViewColumnCollection Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewColumnCollection.cs

Représente une collection d’objets DataGridViewColumn dans un DataGridView contrôle.

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

Héritage

Object

MarshalByRefObject

BaseCollection

DataGridViewColumnCollection

Attributs

ListBindableAttribute

Implémente

ICollection IEnumerable IList

Exemples

L’exemple de code suivant illustre l’utilisation de ce type.

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

Remarques

Vous pouvez récupérer une instance de cette classe via la Columns propriété du DataGridView contrôle. La collection conserve une référence au contrôle via la DataGridView propriété.

Constructeurs

Nom	Description
DataGridViewColumnCollection(DataGridView)	Initialise une nouvelle instance de la DataGridViewColumnCollection classe pour le fichier donné DataGridView.

Propriétés

Nom	Description
Count	Obtient le nombre total d’éléments de la collection. (Hérité de BaseCollection)
DataGridView	Obtient le DataGridView résultat sur lequel la collection effectue des opérations liées aux colonnes.
IsReadOnly	Obtient une valeur indiquant si la collection est en lecture seule. (Hérité de BaseCollection)
IsSynchronized	Obtient une valeur indiquant si l’accès au fichier ICollection est synchronisé. (Hérité de BaseCollection)
Item[Int32]	Obtient ou définit la colonne à l’index donné dans la collection.
Item[String]	Obtient ou définit la colonne du nom donné dans la collection.
List	Obtient la liste des éléments contenus dans l’instance BaseCollection .
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès BaseCollectionau . (Hérité de BaseCollection)

Méthodes

Nom	Description
Add(DataGridViewColumn)	Ajoute la colonne donnée à la collection.
Add(String, String)	Ajoute un DataGridViewTextBoxColumn texte avec le nom de colonne et le texte d’en-tête de colonne donnés à la collection.
AddRange(DataGridViewColumn[])	Ajoute une plage de colonnes à la collection.
Clear()	Efface la collection.
Contains(DataGridViewColumn)	Détermine si la collection contient la colonne donnée.
Contains(String)	Détermine si la collection contient la colonne référencée par le nom donné.
CopyTo(Array, Int32)	Copie tous les éléments de l’élément unidimensionnel Array actuel vers l’index de destination spécifié Array à partir de l’index de destination Array spécifié. (Hérité de BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Copie les éléments de la collection dans le tableau donné.
GetColumnCount(DataGridViewElementStates)	Retourne le nombre de colonnes qui répondent aux exigences de filtre données.
GetColumnsWidth(DataGridViewElementStates)	Retourne la largeur, en pixels, requise pour afficher toutes les colonnes qui répondent aux exigences de filtre données.
GetEnumerator()	Obtient l’objet qui active l’itération via les membres de la collection. (Hérité de BaseCollection)
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Retourne la première colonne dans l’ordre d’affichage qui répond aux exigences de filtre d’inclusion et d’exclusion-filtre.
GetFirstColumn(DataGridViewElementStates)	Retourne la première colonne dans l’ordre d’affichage qui répond aux exigences de filtre d’inclusion données.
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Retourne la dernière colonne dans l’ordre d’affichage qui répond aux exigences de filtre données.
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Obtient la première colonne après la colonne donnée dans l’ordre d’affichage qui répond aux exigences de filtre données.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Obtient la dernière colonne antérieure à la colonne donnée dans l’ordre d’affichage qui répond aux exigences de filtre données.
IndexOf(DataGridViewColumn)	Obtient l’index de l’élément donné DataGridViewColumn dans la collection.
Insert(Int32, DataGridViewColumn)	Insère une colonne à l’index donné dans la collection.
OnCollectionChanged(CollectionChangeEventArgs)	Déclenche l’événement CollectionChanged.
Remove(DataGridViewColumn)	Supprime la colonne spécifiée de la collection.
Remove(String)	Supprime la colonne portant le nom spécifié de la collection.
RemoveAt(Int32)	Supprime la colonne à l’index donné dans la collection.

Événements

Nom	Description
CollectionChanged	Se produit lorsque la collection change.

Implémentations d’interfaces explicites

Nom	Description
ICollection.CopyTo(Array, Int32)	Copie l’intégralité du contenu de la collection dans une dimension unidimensionnelle Arraycompatible, en commençant à l’index spécifié du tableau cible.
ICollection.Count	Obtient le nombre d’éléments de la collection.
ICollection.IsSynchronized	Obtient une valeur indiquant si l’accès à la collection est synchronisé.
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.
IEnumerable.GetEnumerator()	Retourne un énumérateur qui itère dans la collection.
IList.Add(Object)	Ajoute un objet à la fin de la collection.
IList.Clear()	Supprime tous les éléments de la collection.
IList.Contains(Object)	Détermine si un objet se trouve dans la collection.
IList.IndexOf(Object)	Détermine l’index d’un élément spécifique dans la collection.
IList.Insert(Int32, Object)	Insère un élément dans la collection à l’index spécifié.
IList.IsFixedSize	Obtient une valeur indiquant si la collection a une taille fixe.
IList.IsReadOnly	Obtient une valeur indiquant si la collection est en lecture seule.
IList.Item[Int32]	Obtient ou définit l’élément à l’index spécifié.
IList.Remove(Object)	Supprime la première occurrence de l’objet spécifié de la collection.
IList.RemoveAt(Int32)	Supprime l’élément avec l’index spécifié de la collection.

Voir aussi

• DataGridView
• Columns
• DataGridViewColumn