DataGridViewColumnCollection Classe

Définition

Représente une collection d'objets DataGridViewColumn dans un contrôle DataGridView.Represents a collection of DataGridViewColumn objects in a DataGridView control.

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
type DataGridViewColumnCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public Class DataGridViewColumnCollection
Inherits BaseCollection
Implements IList
Héritage
DataGridViewColumnCollection
Attributs
Implémente

Exemples

L’exemple de code suivant illustre l’utilisation de ce type.The following code example illustrates the use of this 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é DataGridView du contrôle.You can retrieve an instance of this class through the Columns property of the DataGridView control. La collection gère une référence au contrôle par le biais DataGridView de la propriété.The collection maintains a reference to the control through the DataGridView property.

Constructeurs

DataGridViewColumnCollection(DataGridView)

Initialise une nouvelle instance de la classe DataGridViewColumnCollection avec le DataGridView donné.Initializes a new instance of the DataGridViewColumnCollection class for the given DataGridView.

Propriétés

Count

Obtient le nombre total d'éléments dans la collection.Gets the total number of elements in the collection.

(Hérité de BaseCollection)
DataGridView

Obtient DataGridView sur lequel la collection exécute des opérations liées aux colonnes.Gets the DataGridView upon which the collection performs column-related operations.

IsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.Gets a value indicating whether the collection is read-only.

(Hérité de BaseCollection)
IsSynchronized

Obtient une valeur indiquant si l’accès à ICollection est synchronisé.Gets a value indicating whether access to the ICollection is synchronized.

(Hérité de BaseCollection)
Item[Int32]

Obtient ou définit la colonne à l'index donné dans la collection.Gets or sets the column at the given index in the collection.

Item[String]

Obtient ou définit la colonne du nom donné dans la collection.Gets or sets the column of the given name in the collection.

List

Obtient la liste des éléments contenus dans l'instance de BaseCollection.Gets the list of elements contained in the BaseCollection instance.

SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à BaseCollection.Gets an object that can be used to synchronize access to the BaseCollection.

(Hérité de BaseCollection)

Méthodes

Add(DataGridViewColumn)

Ajoute la colonne donnée à la collection.Adds the given column to the collection.

Add(String, String)

Ajoute une DataGridViewTextBoxColumn avec le nom et le texte d'en-tête de colonne donnés à la collection.Adds a DataGridViewTextBoxColumn with the given column name and column header text to the collection.

AddRange(DataGridViewColumn[])

Ajoute une plage de colonnes à la collection.Adds a range of columns to the collection.

Clear()

Efface la collection.Clears the collection.

Contains(DataGridViewColumn)

Détermine si la collection contient la colonne donnée.Determines whether the collection contains the given column.

Contains(String)

Détermine si la collection contient la colonne référencée par le nom donné.Determines whether the collection contains the column referred to by the given name.

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é.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(Hérité de BaseCollection)
CopyTo(DataGridViewColumn[], Int32)

Copie les éléments de la collection dans le tableau donné.Copies the items from the collection to the given array.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetColumnCount(DataGridViewElementStates)

Retourne le nombre de colonnes qui répond aux exigences du filtre donné.Returns the number of columns that meet the given filter requirements.

GetColumnsWidth(DataGridViewElementStates)

Retourne la largeur, en pixels, requise pour afficher toutes les colonnes qui répondent aux exigences du filtre donné.Returns the width, in pixels, required to display all of the columns that meet the given filter requirements.

GetEnumerator()

Obtient l'objet qui permet l'itération au sein des membres de la collection.Gets the object that enables iterating through the members of the 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é.Returns the first column in display order that meets the given inclusion-filter requirements.

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Retourne la première colonne dans l'ordre d'affichage qui répond aux exigences du filtre-inclusion et exclusion donné.Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(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é.Returns the last column in display order that meets the given filter requirements.

GetLifetimeService()

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.Retrieves the current lifetime service object that controls the lifetime policy for this 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é.Gets the first column after the given column in display order that meets the given filter requirements.

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é.Gets the last column prior to the given column in display order that meets the given filter requirements.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
IndexOf(DataGridViewColumn)

Obtient l'index du DataGridViewColumn donné dans la collection.Gets the index of the given DataGridViewColumn in the collection.

InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
Insert(Int32, DataGridViewColumn)

Insère une colonne à l'index donné dans la collection.Inserts a column at the given index in the collection.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Déclenche l'événement CollectionChanged.Raises the CollectionChanged event.

Remove(DataGridViewColumn)

Supprime la colonne spécifiée de la collection.Removes the specified column from the collection.

Remove(String)

Supprime de la collection la colonne portant le nom spécifié.Removes the column with the specified name from the collection.

RemoveAt(Int32)

Supprime la colonne à l'index donné de la collection.Removes the column at the given index in the collection.

ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

Événements

CollectionChanged

Se produit lorsque la collection est modifiée.Occurs when the collection changes.

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.Copies the entire contents of the collection to a compatible one-dimensional Array, starting at the specified index of the target array.

ICollection.Count

Obtient le nombre d’éléments de la collection.Gets the number of elements in the collection.

ICollection.IsSynchronized

Obtient une valeur indiquant si l'accès à la collection est synchronisé.Gets a value indicating whether access to the collection is synchronized.

ICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

Retourne un énumérateur qui itère au sein de la collection.Returns an enumerator that iterates through the collection.

IList.Add(Object)

Ajoute un objet à la fin de la collection.Adds an object to the end of the collection.

IList.Clear()

Supprime tous les éléments de la collection.Removes all elements from the collection.

IList.Contains(Object)

Détermine si un objet est dans la collection.Determines whether an object is in the collection.

IList.IndexOf(Object)

Détermine l'index d'un élément spécifique de la collection.Determines the index of a specific item in the collection.

IList.Insert(Int32, Object)

Insère un élément dans la collection à l'index spécifié.Inserts an element into the collection at the specified index.

IList.IsFixedSize

Obtient une valeur indiquant si la collection est de taille fixe.Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

Obtient ou définit l'élément au niveau de l'index spécifié.Gets or sets the element at the specified index.

IList.Remove(Object)

Supprime la première occurrence de l'objet spécifié dans la collection.Removes the first occurrence of the specified object from the collection.

IList.RemoveAt(Int32)

Supprime l'élément de la collection à l'index spécifié.Removes the element with the specified index from the collection.

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi