DataColumnCollection.CanRemove(DataColumn) Méthode

Définition

Vérifie si une colonne spécifique peut être supprimée de la collection.

public:
 bool CanRemove(System::Data::DataColumn ^ column);
public bool CanRemove (System.Data.DataColumn? column);
public bool CanRemove (System.Data.DataColumn column);
member this.CanRemove : System.Data.DataColumn -> bool
Public Function CanRemove (column As DataColumn) As Boolean

Paramètres

column
DataColumn

DataColumn de la collection.

Retours

true si la colonne peut être supprimée. false si,

  • Le paramètre column a la valeur null.

  • La colonne n'appartient pas à cette collection.

  • La colonne fait partie d'une relation.

  • Une expression d'une autre colonne dépend de cette colonne.

Exceptions

Le paramètre column est null.

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 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 RemoveColumn(string columnName, DataTable table)
{
    DataColumnCollection columns = table.Columns;
    if (columns.Contains(columnName))
        if (columns.CanRemove(columns[columnName]))
            columns.Remove(columnName);
}
Private Sub RemoveColumn( _
    columnName As String, table As DataTable)

    Dim columns As DataColumnCollection = table.Columns
    If columns.Contains(columnName) Then 
        If columns.CanRemove(columns(columnName)) Then 
           columns.Remove(columnName)
        End If
    End If
End Sub

Remarques

La CanRemove méthode effectue plusieurs vérifications avant de retourner un true résultat ou false . Cela inclut les éléments suivants : si la colonne existe, appartient à la table ou est impliquée dans une contrainte ou une relation.

Utilisez la CanRemove méthode avant d’essayer de supprimer une colonne d’une collection. Vous pouvez également utiliser la Contains méthode pour déterminer si une colonne particulière existe avant d’essayer de la supprimer.

S’applique à

Voir aussi