DataColumnCollection.Remove Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Quita un objeto DataColumn de la colección.

Sobrecargas

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

Remove(DataColumn)

Source:

DataColumnCollection.cs

Quita el objeto DataColumn especificado 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

DataColumn que se va a quitar.

Excepciones

ArgumentNullException

El parámetro column 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 método lo Remove 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

• Contains(String)
• CanRemove(DataColumn)
• Item[Int32]

Remove(String)

Source:

DataColumnCollection.cs

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

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 ninguna 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

• Contains(String)