DataGridViewColumnCollection.Remove Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Supprime une colonne de la collection.

Surcharges

Remove(String)

Supprime de la collection la colonne portant le nom spécifié.
Remove(DataGridViewColumn)

Supprime la colonne spécifiée de la collection.

Remove(String)

Supprime de la collection la colonne portant le nom spécifié.

public:
 virtual void Remove(System::String ^ columnName);
public virtual void Remove (string columnName);
abstract member Remove : string -> unit
override this.Remove : string -> unit
Public Overridable Sub Remove (columnName As String)

Paramètres

columnName
String

Nom de la colonne à supprimer.

Exceptions

ArgumentException

columnName ne correspond au nom d'aucune colonne dans la collection.

ArgumentNullException

columnName 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 dans le contrôle.

  • Suppression de la sélection.

  • Mise à jour des valeurs de propriété de colonne DisplayIndex .

- ou -

Cette méthode est appelée à partir d’un gestionnaire d’un des événements DataGridView suivants :

Exemples

L’exemple de code suivant illustre l’utilisation de cette méthode. Pour plus d’informations, consultez Guide pratique pour supprimer des colonnes générées automatiquement d’un contrôle DataGridView Windows Forms.

private void BindDataAndInitializeColumns()
{
    dataGridView1.AutoGenerateColumns = true;
    dataGridView1.DataSource = customersDataSet;
    dataGridView1.Columns.Remove("Fax");
    dataGridView1.Columns["CustomerID"].Visible = false;
}

Private Sub BindDataAndInitializeColumns()

    With dataGridView1
        .AutoGenerateColumns = True
        .DataSource = customersDataSet
        .Columns.Remove("Fax")
        .Columns("CustomerID").Visible = False
    End With

End Sub

Remarques

Le nom d’une colonne est indiqué par la DataGridViewColumn.Name propriété .

Pour supprimer une colonne générée automatiquement lors de la liaison à une source de données, appelez cette méthode dans un gestionnaire d’événements DataGridView.DataBindingComplete .

Voir aussi

S’applique à

Remove(DataGridViewColumn)

Supprime la colonne spécifiée de la collection.

public:
 virtual void Remove(System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);
public virtual void Remove (System.Windows.Forms.DataGridViewColumn dataGridViewColumn);
abstract member Remove : System.Windows.Forms.DataGridViewColumn -> unit
override this.Remove : System.Windows.Forms.DataGridViewColumn -> unit
Public Overridable Sub Remove (dataGridViewColumn As DataGridViewColumn)

Paramètres

dataGridViewColumn
DataGridViewColumn

Colonne à supprimer.

Exceptions

ArgumentException

dataGridViewColumn n'est pas dans la collection.

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 dans le contrôle.

  • Suppression de la sélection.

  • Mise à jour des valeurs de propriété de colonne DisplayIndex .

- ou -

Cette méthode est appelée à partir d’un gestionnaire d’un des événements DataGridView suivants :

Remarques

Pour supprimer une colonne générée automatiquement lors de la liaison à une source de données, appelez cette méthode dans un gestionnaire d’événements DataGridView.DataBindingComplete .

Voir aussi

S’applique à