DataTableCollection.Remove DataTableCollection.Remove DataTableCollection.Remove DataTableCollection.Remove Method

Définition

Supprime un objet DataTable spécifié de la collection.Removes a specified DataTable object from the collection.

Surcharges

Remove(String, String) Remove(String, String) Remove(String, String) Remove(String, String)

Supprime de la collection l’objet DataTable avec le nom spécifié.Removes the DataTable object with the specified name from the collection.

Remove(DataTable) Remove(DataTable) Remove(DataTable) Remove(DataTable)

Supprime l'objet DataTable spécifié de la collection.Removes the specified DataTable object from the collection.

Remove(String) Remove(String) Remove(String) Remove(String)

Supprime de la collection l’objet DataTable avec le nom spécifié.Removes the DataTable object with the specified name from the collection.

Remove(String, String) Remove(String, String) Remove(String, String) Remove(String, String)

Supprime de la collection l’objet DataTable avec le nom spécifié.Removes the DataTable object with the specified name from the collection.

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)

Paramètres

name
String String String String

Nom de l’objet DataTable à supprimer.The name of the DataTable object to remove.

tableNamespace
String String String String

Nom de l'espace de noms DataTable dans lequel rechercher.The name of the DataTable namespace to look in.

Exceptions

La collection ne possède pas de table portant le nom spécifié.The collection does not have a table with the specified name.

Exemples

L’exemple suivant utilise les Contains méthodes CanRemove et pour tester si une table nommée existe et peut être supprimée.The following example uses the Contains and CanRemove methods to test whether a named table exists and can be removed. Si c’est le Remove cas, la méthode est appelée pour supprimer la table.If so, the Remove method is called to remove the table.

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

Remarques

L' CollectionChanged événement se produit lorsqu’une table est supprimée avec succès.The CollectionChanged event occurs when a table is successfully removed.

Pour déterminer si une table donnée existe et peut être supprimée avant d' Removeappeler, utilisez Contains les CanRemove méthodes et.To determine whether a given table exists and can be removed before invoking Remove, use the Contains and the CanRemove methods.

Voir aussi

Remove(DataTable) Remove(DataTable) Remove(DataTable) Remove(DataTable)

Supprime l'objet DataTable spécifié de la collection.Removes the specified DataTable object from the collection.

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)

Paramètres

table
DataTable DataTable DataTable DataTable

DataTable à supprimer.The DataTable to remove.

Exceptions

La valeur spécifiée pour la table est null.The value specified for the table is null.

La table n'appartient pas à cette collection.The table does not belong to this collection.

ou-or-

La table fait partie d'une relation.The table is part of a relationship.

Exemples

L’exemple suivant utilise la CanRemove méthode pour tester si chaque table peut être supprimée d' DataSetun.The following example uses the CanRemove method to test whether each table can be removed from a DataSet. Si c’est le Remove cas, la méthode est appelée pour supprimer la table.If so, the Remove method is called to remove the table.

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 DataSet = New DataSet()

       ' create Customer table
       Dim customersTable As DataTable = 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 DataTable = 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

Remarques

L' CollectionChanged événement se produit lorsqu’une table est supprimée avec succès.The CollectionChanged event occurs when a table is successfully removed.

Pour déterminer si une table donnée existe et peut être supprimée avant d' Removeappeler, utilisez Contains les CanRemove méthodes et.To determine whether a given table exists and can be removed before invoking Remove, use the Contains and the CanRemove methods.

Voir aussi

Remove(String) Remove(String) Remove(String) Remove(String)

Supprime de la collection l’objet DataTable avec le nom spécifié.Removes the DataTable object with the specified name from the collection.

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

Paramètres

name
String String String String

Nom de l’objet DataTable à supprimer.The name of the DataTable object to remove.

Exceptions

La collection ne possède pas de table portant le nom spécifié.The collection does not have a table with the specified name.

Exemples

L’exemple suivant utilise les Contains méthodes CanRemove et pour tester si une table nommée existe et peut être supprimée.The following example uses the Contains and CanRemove methods to test whether a named table exists and can be removed. Si c’est le Remove cas, la méthode est appelée pour supprimer la table.If so, the Remove method is called to remove the table.

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

Remarques

L' CollectionChanged événement se produit lorsqu’une table est supprimée avec succès.The CollectionChanged event occurs when a table is successfully removed.

Pour déterminer si une table donnée existe et peut être supprimée avant d' Removeappeler, utilisez Contains les CanRemove méthodes et.To determine whether a given table exists and can be removed before invoking Remove, use the Contains and the CanRemove methods.

Voir aussi

S’applique à