DataGridViewColumnCollection.Add Méthode

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.

Ajoute la colonne donnée à la collection.

Surcharges

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.

Add(DataGridViewColumn)

Ajoute la colonne donnée à la collection.

public:
 virtual int Add(System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);

public virtual int Add (System.Windows.Forms.DataGridViewColumn dataGridViewColumn);

abstract member Add : System.Windows.Forms.DataGridViewColumn -> int
override this.Add : System.Windows.Forms.DataGridViewColumn -> int

Public Overridable Function Add (dataGridViewColumn As DataGridViewColumn) As Integer

Paramètres

dataGridViewColumn: DataGridViewColumn

DataGridViewColumn à ajouter.

Retours

Int32

Index de la colonne.

Exceptions

ArgumentNullException

dataGridViewColumn a la valeur null.

InvalidOperationException

Le contrôle DataGridView associé exécute l'une des opérations suivantes qui empêchent temporairement l'ajout de nouvelles colonnes :

Sélection de toutes les cellules contenues dans le contrôle.
Effacement de la sélection.
Mise à jour des valeurs de propriété DisplayIndex de la colonne.
ou - Cette méthode est appelée à partir d’un gestionnaire d’un des événements DataGridView suivants :
CellEnter
CellLeave
CellValidating
CellValidated
RowEnter
RowLeave
RowValidated
RowValidating
ou - dataGridViewColumn appartient déjà à un contrôle DataGridView.
ou - La valeur de propriété dataGridViewColumnSortMode est Automatic et la valeur de propriété SelectionMode est FullColumnSelect ou ColumnHeaderSelect. Utilisez les méthodes ISupportInitialize.BeginInit() et ISupportInitialize.EndInit() du contrôle pour définir temporairement des valeurs de propriétés en conflit.
ou - La valeur de propriété dataGridViewColumnInheritedAutoSizeMode est ColumnHeader et la valeur de propriété ColumnHeadersVisible est false.
ou - dataGridViewColumn a une valeur de propriété InheritedAutoSizeMode de Fill et une valeur de propriété Frozen de true.
ou - dataGridViewColumn a une valeur de propriété FillWeight qui ferait en sorte que les valeurs FillWeight combinées de toutes les colonnes dans le contrôle dépassent 65 535.
ou - dataGridViewColumn a des valeurs de propriété DisplayIndex et Frozen qui l'afficheraient parmi un jeu de colonnes adjacentes avec la valeur de propriété Frozen opposée.
ou - Le contrôle DataGridView contient au moins une ligne et dataGridViewColumn a une valeur de propriété CellType de null.

Exemples

L’exemple de code suivant illustre l’utilisation de cette méthode.

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

Voir aussi

S’applique à

.NET Framework 4.8 et autres versions

Produit	Versions
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop	3.0, 3.1, 5, 6, 7

Add(String, String)

Ajoute une DataGridViewTextBoxColumn avec le nom et le texte d'en-tête de colonne donnés à la collection.

public:
 virtual int Add(System::String ^ columnName, System::String ^ headerText);

public virtual int Add (string columnName, string headerText);

abstract member Add : string * string -> int
override this.Add : string * string -> int

Public Overridable Function Add (columnName As String, headerText As String) As Integer

Paramètres

columnName: String

Nom par lequel la colonne est référencée.

headerText: String

Texte de l'en-tête de la colonne.

Retours

Int32

Index de la colonne.

Exceptions

InvalidOperationException

Le contrôle DataGridView associé exécute l'une des opérations suivantes qui empêchent temporairement l'ajout de nouvelles colonnes :

Sélection de toutes les cellules contenues dans le contrôle.
Effacement de la sélection.
Mise à jour des valeurs de propriété DisplayIndex de la colonne.
ou - Cette méthode est appelée à partir d’un gestionnaire d’un des événements DataGridView suivants :
CellEnter
CellLeave
CellValidating
CellValidated
RowEnter
RowLeave
RowValidated
RowValidating
ou - La valeur de propriété SelectionMode est FullColumnSelect ou ColumnHeaderSelect, ce qui est en conflit avec la valeur de propriété SortMode de colonne par défaut Automatic.
ou - Une valeur de propriété FillWeight de colonne par défaut de 100 ferait en sorte que les valeurs FillWeight combinées de toutes les colonnes dans le contrôle dépassent 65 535.

Remarques

Les columnName paramètres et headerText les paramètres sont liés aux propriétés et HeaderText aux Name propriétés, respectivement.

Voir aussi

S’applique à

.NET Framework 4.8 et autres versions

Produit	Versions
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop	3.0, 3.1, 5, 6, 7

Partager via

DataGridViewColumnCollection.Add Méthode

Définition

Surcharges

Add(DataGridViewColumn)

Paramètres

Retours

Exceptions

Exemples

Voir aussi

S’applique à

Add(String, String)

Paramètres

Retours

Exceptions

Remarques

Voir aussi

S’applique à

Ressources supplémentaires