DataColumnCollection.Remove Méthode

Définition

Espace de noms:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Supprime un DataColumn objet de la collection.

Surcharges

Nom Description
Remove(DataColumn)

Supprime l’objet spécifié DataColumn de la collection.
Remove(String)

Supprime l’objet DataColumn qui a le nom spécifié de la collection.

Remove(DataColumn)

Supprime l’objet spécifié DataColumn de la collection.

public:
 void Remove(System::Data::DataColumn ^ column);
public void Remove(System.Data.DataColumn column);
member this.Remove : System.Data.DataColumn -> unit
Public Sub Remove (column As DataColumn)

Paramètres

column
DataColumn

À DataColumn supprimer.

Exceptions

ArgumentNullException

Le column paramètre est null.

ArgumentException

La colonne n’appartient pas à cette collection.

- Ou -

La colonne fait partie d’une relation.

- Ou -

L’expression d’une autre colonne dépend de cette colonne.

Exemples

L’exemple suivant utilise la Contains méthode pour déterminer si une colonne nommée existe. Si c’est le cas, la Item[] propriété retourne la colonne. La CanRemove méthode vérifie ensuite si la colonne peut être supprimée ; si c’est le cas, la méthode la Remove supprime.

private void TestAndRemove(DataColumn colToRemove)
{
    DataColumnCollection columns;
    // Get the DataColumnCollection from a DataTable in a DataSet.
    columns = DataSet1.Tables["Orders"].Columns;

    if(columns.Contains(colToRemove.ColumnName))
    {
        columns.Remove(colToRemove);
    }
}

Private Sub TestAndRemove(ByVal colToRemove As DataColumn)
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    If columns.Contains(colToRemove.ColumnName) Then
       columns.Remove(colToRemove)
    End If
End Sub

Remarques

Si la collection est correctement modifiée en ajoutant ou en supprimant des colonnes, l’événement CollectionChanged se produit.

Voir aussi

S’applique à

Remove(String)

Supprime l’objet DataColumn qui a le nom spécifié de la collection.

public:
 void Remove(System::String ^ name);
public void Remove(string name);
member this.Remove : string -> unit
Public Sub Remove (name As String)

Paramètres

name
String

Nom de la colonne à supprimer.

Exceptions

ArgumentException

La collection n’a pas de colonne portant le nom spécifié.

Exemples

L’exemple suivant utilise d’abord la Contains méthode pour déterminer si une colonne particulière est trouvée dans la collection. Si elle est trouvée, la CanRemove méthode teste si la colonne peut être supprimée. Si c’est le cas, la colonne est supprimée avec la Remove méthode.

private void RemoveColumnByName(string columnName)
{
    // Get the DataColumnCollection from a DataTable in a DataSet.
    DataColumnCollection columns =
        ds.Tables["Suppliers"].Columns;

    if(columns.Contains(columnName))
        if(columns.CanRemove(columns[columnName]))
            columns.Remove(columnName);
}

Private Sub RemoveColumnByName(columnName As String)

    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns

    If columns.Contains(columnName) Then 
        If columns.CanRemove(columns(columnName)) Then 
            columns.Remove(columnName)
        End If
    End If
 End Sub

Remarques

Si la collection est correctement modifiée en ajoutant ou en supprimant des colonnes, l’événement CollectionChanged se produit.

Voir aussi

S’applique à