DataGridViewColumnCollection.Remove Méthode
Définition
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.
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
columnName
ne correspond au nom d'aucune colonne dans la collection.
columnName
a la valeur null
.
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
dataGridViewColumn
n'est pas dans la collection.
dataGridViewColumn
a la valeur null
.
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 .