DataColumnCollection.Remove Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Supprime un objet DataColumn de la collection.

Surcharges

Remove(DataColumn)	Supprime l'objet DataColumn spécifié de la collection.
Remove(String)	Supprime de la collection l'objet DataColumn portant le nom spécifié.

Remove(DataColumn)

Source:

DataColumnCollection.cs

Supprime l'objet DataColumn spécifié 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 paramètre column a la valeur null.

ArgumentException

La colonne n'appartient pas à cette collection.

-Ou-

La colonne fait partie d'une relation.

-Ou-

Une 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 modifiée avec succès en ajoutant ou en supprimant des colonnes, l’événement CollectionChanged se produit.

Voir aussi

• Contains(String)
• CanRemove(DataColumn)
• Item[Int32]

Remove(String)

Source:

DataColumnCollection.cs

Supprime de la collection l'objet DataColumn portant le nom spécifié.

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 ne possède 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 se trouve 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 modifiée avec succès en ajoutant ou en supprimant des colonnes, l’événement CollectionChanged se produit.

Voir aussi

• Contains(String)