DataColumnCollection.CanRemove(DataColumn) Método

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

Parâmetros

Retornos

true se a coluna puder ser removida. false Se

• O column parâmetro é null.

• A coluna não pertence a essa coleção.

• A coluna faz parte de uma relação.

• A expressão de outra coluna depende dessa coluna.

Exceções

Exemplos

O exemplo a seguir usa primeiro o Contains método para determinar se uma determinada coluna é encontrada na coleção. Se encontrado, o CanRemove método testa se a coluna pode ser removida. Nesse caso, a coluna será removida com o Remove método.

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

Comentários

O CanRemove método executa várias verificações antes de retornar um resultado ou false um true resultado. Isso inclui o seguinte: se a coluna existe, pertence à tabela ou está envolvida em uma restrição ou relação.

Use o CanRemove método antes de tentar remover qualquer coluna de uma coleção. Você também pode usar o Contains método para determinar se existe uma determinada coluna antes de tentar removê-la.

Confira também

• Contains(String)
• Remove(DataColumn)