DataColumnCollection.CanRemove(DataColumn) Méthode

Référence

Définition

Espace de noms:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

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.

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

Boolean

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

ArgumentNullException

Le paramètre column est 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 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 à