DataColumnCollection.Remove Método

Definição

Espaço de Nomes:
System.Data
Assemblagens:
netstandard.dll, System.Data.Common.dll
Assemblagem:
System.Data.Common.dll
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Remove um DataColumn objeto da coleção.

Sobrecargas

Name Description
Remove(DataColumn)

Remove o objeto especificado DataColumn da coleção.
Remove(String)

Remove o DataColumn objeto que tem o nome especificado da coleção.

Remove(DataColumn)

Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs

Remove o objeto especificado DataColumn da coleção.

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)

Parâmetros

column
DataColumn

O DataColumn para remover.

Exceções

ArgumentNullException

O column parâmetro é null.

ArgumentException

A coluna não pertence a esta coleção.

-Ou-

A coluna faz parte de uma relação.

-Ou-

A expressão de outra coluna depende desta coluna.

Exemplos

O exemplo seguinte utiliza o Contains método para determinar se existe uma coluna nomeada. Se assim for, a Item[] propriedade devolve a coluna. O CanRemove método verifica então se a coluna pode ser removida; se sim, o Remove método remove-a.

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

Observações

Se a coleção for alterada com sucesso através da adição ou remoção de colunas, o CollectionChanged evento ocorre.

Ver também

Aplica-se a

Remove(String)

Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs
Origem:
DataColumnCollection.cs

Remove o DataColumn objeto que tem o nome especificado da coleção.

public:
 void Remove(System::String ^ name);
public void Remove(string name);
member this.Remove : string -> unit
Public Sub Remove (name As String)

Parâmetros

name
String

O nome da coluna a remover.

Exceções

ArgumentException

A coleção não tem uma coluna com o nome especificado.

Exemplos

O exemplo seguinte utiliza primeiro o Contains método para determinar se uma determinada coluna se encontra na coleção. Se for encontrado, o CanRemove método testa se a coluna pode ser removida. Se sim, a coluna é removida com o Remove método.

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

Observações

Se a coleção for alterada com sucesso através da adição ou remoção de colunas, o CollectionChanged evento ocorre.

Ver também

Aplica-se a