DataColumnCollection.Remove Método

Definición

Espacio de nombres:
System.Data
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll

Quita un DataColumn objeto de la colección.

Sobrecargas

Nombre Description
Remove(DataColumn)

Quita el objeto especificado DataColumn de la colección.
Remove(String)

Quita el DataColumn objeto que tiene el nombre especificado de la colección.

Remove(DataColumn)

Quita el objeto especificado DataColumn de la colección.

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

que DataColumn se va a quitar.

Excepciones

ArgumentNullException

El column parámetro es null.

ArgumentException

La columna no pertenece a esta colección.

-O bien-

La columna forma parte de una relación.

-O bien-

La expresión de otra columna depende de esta columna.

Ejemplos

En el ejemplo siguiente se usa el Contains método para determinar si existe una columna con nombre. Si es así, la Item[] propiedad devuelve la columna. A CanRemove continuación, el método comprueba si se puede quitar la columna; si es así, el Remove método lo quita.

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

Comentarios

Si la colección cambia correctamente agregando o quitando columnas, se produce el CollectionChanged evento .

Consulte también

Se aplica a

Remove(String)

Quita el DataColumn objeto que tiene el nombre especificado de la colección.

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

Nombre de la columna que se va a quitar.

Excepciones

ArgumentException

La colección no tiene una columna con el nombre especificado.

Ejemplos

En el ejemplo siguiente se usa primero el Contains método para determinar si se encuentra una columna determinada en la colección. Si se encuentra, el CanRemove método comprueba si se puede quitar la columna. Si es así, la columna se quita con el 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

Comentarios

Si la colección cambia correctamente agregando o quitando columnas, se produce el CollectionChanged evento .

Consulte también

Se aplica a