DataColumnCollection.Contains(String) Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataColumnCollection.cs

Verifica se a coleção tem uma coluna com o nome especificado.

public:
 bool Contains(System::String ^ name);

public bool Contains (string name);

member this.Contains : string -> bool

Public Function Contains (name As String) As Boolean

Parâmetros

name

String

O ColumnName da coluna a ser pesquisada.

Retornos

Boolean

true se existir uma coluna com este nome; caso contrário, false.

Exemplos

O exemplo a seguir usa o Contains método e o CanRemove método para determinar se a coluna pode ser removida. Nesse caso, a coluna será removida.

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

Use o Contains método para confirmar a existência de uma coluna antes de executar operações adicionais na coluna. O método retorna false quando duas ou mais colunas têm o mesmo nome, mas namespaces diferentes. A chamada não terá êxito se houver alguma ambiguidade ao corresponder um nome de coluna a exatamente uma coluna.

Confira também

• CanRemove(DataColumn)
• IndexOf(DataColumn)