DataGridViewColumnCollection Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente une collection d’objets DataGridViewColumn d’un contrôle 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

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 un 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

DataGridViewColumnCollection(DataGridView)

Initialise une nouvelle instance de la classe DataGridViewColumnCollection avec le DataGridView donné.

Propriétés

Count	Obtient le nombre total d'éléments dans la collection. (Hérité de BaseCollection)
DataGridView	Obtient DataGridView sur lequel la collection exécute 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 à 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 de BaseCollection.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à BaseCollection. (Hérité de BaseCollection)

Méthodes

Add(DataGridViewColumn)	Ajoute la colonne donnée à la collection.
Add(String, String)	Ajoute une DataGridViewTextBoxColumn avec le nom 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 du Array unidimensionnel en cours dans le Array unidimensionnel spécifié en commençant à l'index Array de destination spécifié. (Hérité de BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Copie les éléments de la collection dans le tableau donné.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetColumnCount(DataGridViewElementStates)	Retourne le nombre de colonnes qui répond aux exigences du filtre donné.
GetColumnsWidth(DataGridViewElementStates)	Retourne la largeur, en pixels, requise pour afficher toutes les colonnes qui répondent aux exigences du filtre donné.
GetEnumerator()	Obtient l'objet qui permet l'itération au sein des membres de la collection. (Hérité de BaseCollection)
GetFirstColumn(DataGridViewElementStates)	Retourne la première colonne dans l'ordre d'affichage qui répond aux exigences du filtre-inclusion donné.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Retourne la première colonne dans l'ordre d'affichage qui répond aux exigences du filtre-inclusion et exclusion donné.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Retourne la dernière colonne dans l'ordre d'affichage qui répond aux exigences du filtre donné.
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
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 du filtre donné.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Obtient la dernière colonne avant la colonne donnée dans l'ordre d'affichage qui répond aux exigences du filtre donné.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(DataGridViewColumn)	Obtient l'index du DataGridViewColumn donné dans la collection.
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
Insert(Int32, DataGridViewColumn)	Insère une colonne à l'index donné dans la collection.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Déclenche l’événement CollectionChanged.
Remove(DataGridViewColumn)	Supprime la colonne spécifiée de la collection.
Remove(String)	Supprime de la collection la colonne portant le nom spécifié.
RemoveAt(Int32)	Supprime la colonne à l'index donné de la collection.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

CollectionChanged

Se produit lorsque la collection est modifiée.

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)	Copie le contenu entier de la collection dans un Array unidimensionnel compatible, 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 qui indique 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 au sein de 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 est dans la collection.
IList.IndexOf(Object)	Détermine l'index d'un élément spécifique de 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 est de 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 au niveau de l'index spécifié.
IList.Remove(Object)	Supprime la première occurrence de l’objet spécifié dans la collection.
IList.RemoveAt(Int32)	Supprime l'élément de la collection à l'index spécifié.

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à