DataTableCollection.Remove Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Supprime un objet DataTable spécifié de la collection.

Surcharges

Remove(String, String)	Supprime de la collection l’objet DataTable avec le nom spécifié.
Remove(DataTable)	Supprime l'objet DataTable spécifié de la collection.
Remove(String)	Supprime de la collection l’objet DataTable avec le nom spécifié.

Remove(String, String)

Source:

DataTableCollection.cs

Supprime de la collection l’objet DataTable avec le nom spécifié.

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

Nom de l’objet DataTable à supprimer.

tableNamespace

String

Nom de l'espace de noms DataTable dans lequel rechercher.

Exceptions

ArgumentException

La collection ne possède pas de table portant le nom spécifié.

Exemples

L’exemple suivant utilise les Contains méthodes et CanRemove pour tester si une table nommée existe et peut être supprimée. Si c’est le cas, la Remove méthode est appelée pour supprimer la 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’événement CollectionChanged se produit lorsqu’une table est supprimée avec succès.

Pour déterminer si une table donnée existe et peut être supprimée avant d’appeler Remove, utilisez les Contains méthodes et CanRemove .

Voir aussi

• IndexOf(DataTable)
• Contains(String)

Remove(DataTable)

Source:

DataTableCollection.cs

Supprime l'objet DataTable spécifié de la 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 à supprimer.

Exceptions

ArgumentNullException

La valeur spécifiée pour la table est null.

ArgumentException

La table n'appartient pas à cette collection.

- ou -

La table fait partie d'une relation.

Exemples

L’exemple suivant utilise la CanRemove méthode pour tester si chaque table peut être supprimée d’un DataSet. Si c’est le cas, la Remove méthode est appelée pour supprimer la 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 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

Remarques

L’événement CollectionChanged se produit lorsqu’une table est supprimée avec succès.

Pour déterminer si une table donnée existe et peut être supprimée avant d’appeler Remove, utilisez les Contains méthodes et CanRemove .

Voir aussi

• IndexOf(DataTable)
• Contains(String)

Remove(String)

Source:

DataTableCollection.cs

Supprime de la collection l’objet DataTable avec le nom spécifié.

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

Nom de l’objet DataTable à supprimer.

Exceptions

ArgumentException

La collection ne possède pas de table portant le nom spécifié.

Exemples

L’exemple suivant utilise les Contains méthodes et CanRemove pour tester si une table nommée existe et peut être supprimée. Si c’est le cas, la Remove méthode est appelée pour supprimer la 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’événement CollectionChanged se produit lorsqu’une table est supprimée avec succès.

Pour déterminer si une table donnée existe et peut être supprimée avant d’appeler Remove, utilisez les Contains méthodes et CanRemove .

Voir aussi

• IndexOf(DataTable)
• Contains(String)