DataTableCollection.Remove Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Quita un objeto DataTable especificado de la colección.

Sobrecargas

Remove(String, String)	Quita el objeto DataTable con el nombre especificado de la colección.
Remove(DataTable)	Quita el objeto DataTable especificado de la colección.
Remove(String)	Quita el objeto DataTable con el nombre especificado de la colección.

Remove(String, String)

Source:

DataTableCollection.cs

Quita el objeto DataTable con el nombre especificado de la colección.

public:
 void Remove(System::String ^ name, System::String ^ tableNamespace);

public void Remove (string name, string tableNamespace);

member this.Remove : string * string -> unit

Public Sub Remove (name As String, tableNamespace As String)

Parámetros

name

String

El nombre del objeto DataTable que se va a quitar.

tableNamespace

String

Nombre del espacio de nombres de DataTable en el que se va a buscar.

Excepciones

ArgumentException

La colección no tiene ninguna tabla con el nombre especificado.

Ejemplos

En el ejemplo siguiente se usan los Contains métodos y CanRemove para probar si existe una tabla con nombre y se puede quitar. Si es así, Remove se llama al método para quitar la tabla.

private void RemoveTables()
{
    // Set the name of the table to test for and remove.
    string name = "Suppliers";

    // Presuming a DataGrid is displaying more than one table, get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;
    DataTableCollection tablesCol = thisDataSet.Tables;
    if (tablesCol.Contains(name) && tablesCol.CanRemove(tablesCol[name]))
        tablesCol.Remove(name);
}

Private Sub RemoveTables()
   ' Set the name of the table to test for and remove.
   Dim name As String = "Suppliers"

   ' Presuming a DataGrid is displaying more than one table, get its DataSet.
   Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)
   Dim tablesCol As DataTableCollection = thisDataSet.Tables
   If tablesCol.Contains(name) _
   And tablesCol.CanRemove(tablesCol(name)) Then 
      tablesCol.Remove(name)
   End If
End Sub

Comentarios

El CollectionChanged evento se produce cuando se quita correctamente una tabla.

Para determinar si existe una tabla determinada y se puede quitar antes de invocar Remove, use los Contains métodos y CanRemove .

Consulte también

• IndexOf(DataTable)
• Contains(String)

Remove(DataTable)

Source:

DataTableCollection.cs

Quita el objeto DataTable especificado de la colección.

public:
 void Remove(System::Data::DataTable ^ table);

public void Remove (System.Data.DataTable table);

member this.Remove : System.Data.DataTable -> unit

Public Sub Remove (table As DataTable)

Parámetros

table

DataTable

DataTable que se va a quitar.

Excepciones

ArgumentNullException

El valor especificado para la tabla es null.

ArgumentException

La tabla no pertenece a esta colección.

o bien

La tabla forma parte de una relación.

Ejemplos

En el ejemplo siguiente se usa el CanRemove método para probar si cada tabla se puede quitar de .DataSet Si es así, Remove se llama al método para quitar la tabla.

public static void DataTableCollectionCanRemove()
{
    // create a DataSet with two tables
    DataSet dataSet = new DataSet();

    // create Customer table
    DataTable customersTable = new DataTable("Customers");
    customersTable.Columns.Add("customerId",
        typeof(int) ).AutoIncrement = true;
    customersTable.Columns.Add("name",
        typeof(string));
    customersTable.PrimaryKey = new DataColumn[]
        { customersTable.Columns["customerId"] };

    // create Orders table
    DataTable ordersTable = new DataTable("Orders");
    ordersTable.Columns.Add("orderId",
        typeof(int) ).AutoIncrement = true;
    ordersTable.Columns.Add("customerId",
        typeof(int) );
    ordersTable.Columns.Add("amount",
        typeof(double));
    ordersTable.PrimaryKey = new DataColumn[]
        { ordersTable.Columns["orderId"] };

    dataSet.Tables.AddRange(new DataTable[]
        {customersTable, ordersTable });

    // remove all tables
    // check if table can be removed and then
    // remove it, cannot use a foreach when
    // removing items from a collection
    while(dataSet.Tables.Count > 0)
    {
        DataTable table = dataSet.Tables[0];
        if(dataSet.Tables.CanRemove(table))
        {
            dataSet.Tables.Remove(table);
        }
    }

    Console.WriteLine("dataSet has {0} tables",
        dataSet.Tables.Count);
}

Public Sub Main
DataTableCollectionCanRemove
End Sub

Public Sub DataTableCollectionCanRemove()
    ' create a DataSet with two tables
    Dim dataSet As New DataSet()

    ' create Customer table
    Dim customersTable As New DataTable("Customers")
    customersTable.Columns.Add("customerId", _
        System.Type.GetType("System.Integer")).AutoIncrement = True
    customersTable.Columns.Add("name", _
        System.Type.GetType("System.String"))
    customersTable.PrimaryKey = New DataColumn() _
        {customersTable.Columns("customerId")}

    ' create Orders table
    Dim ordersTable As New DataTable("Orders")
    ordersTable.Columns.Add("orderId", _
        System.Type.GetType("System.Integer")).AutoIncrement = True
    ordersTable.Columns.Add("customerId", _
        System.Type.GetType("System.Integer"))
    ordersTable.Columns.Add("amount", _
        System.Type.GetType("System.Double"))
    ordersTable.PrimaryKey = New DataColumn() _
        {ordersTable.Columns("orderId")}

    dataSet.Tables.AddRange(New DataTable() {customersTable, ordersTable})

    ' remove all tables
    ' check if table can be removed and then
    ' remove it, cannot use a foreach when
    ' removing items from a collection
    Do While (dataSet.Tables.Count > 0)
        Dim table As DataTable = dataSet.Tables(0)
        If (dataSet.Tables.CanRemove(table)) Then
            dataSet.Tables.Remove(table)
        End If
    Loop

Console.WriteLine("dataSet has {0} tables", dataSet.Tables.Count)
End Sub

Comentarios

El CollectionChanged evento se produce cuando se quita correctamente una tabla.

Para determinar si existe una tabla determinada y se puede quitar antes de invocar Remove, use los Contains métodos y CanRemove .

Consulte también

• IndexOf(DataTable)
• Contains(String)

Remove(String)

Source:

DataTableCollection.cs

Quita el objeto DataTable con 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

El nombre del objeto DataTable que se va a quitar.

Excepciones

ArgumentException

La colección no tiene ninguna tabla con el nombre especificado.

Ejemplos

En el ejemplo siguiente se usan los Contains métodos y CanRemove para probar si existe una tabla con nombre y se puede quitar. Si es así, Remove se llama al método para quitar la tabla.

private void RemoveTables()
{
    // Set the name of the table to test for and remove.
    string name = "Suppliers";

    // Presuming a DataGrid is displaying more than one table, get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;
    DataTableCollection tablesCol = thisDataSet.Tables;
    if (tablesCol.Contains(name) && tablesCol.CanRemove(tablesCol[name]))
        tablesCol.Remove(name);
}

Private Sub RemoveTables()
   ' Set the name of the table to test for and remove.
   Dim name As String = "Suppliers"

   ' Presuming a DataGrid is displaying more than one table, get its DataSet.
   Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)
   Dim tablesCol As DataTableCollection = thisDataSet.Tables
   If tablesCol.Contains(name) _
   And tablesCol.CanRemove(tablesCol(name)) Then 
      tablesCol.Remove(name)
   End If
End Sub

Comentarios

El CollectionChanged evento se produce cuando se quita correctamente una tabla.

Para determinar si existe una tabla determinada y se puede quitar antes de invocar Remove, use los Contains métodos y CanRemove .

Consulte también

• IndexOf(DataTable)
• Contains(String)