DataTableCollection.Remove Metodo

Definizione

Rimuove un oggetto DataTable specificato dalla raccolta.

Overload

Remove(String, String)

Rimuove dalla raccolta l'oggetto DataTable con il nome specificato.

Remove(DataTable)

Rimuove l'oggetto DataTable specificato dalla raccolta.

Remove(String)

Rimuove dalla raccolta l'oggetto DataTable con il nome specificato.

Remove(String, String)

Rimuove dalla raccolta l'oggetto DataTable con il nome specificato.

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)

Parametri

name
String

Nome dell'oggetto DataTable da rimuovere.

tableNamespace
String

Nome dello spazio dei nomi DataTable in cui eseguire la ricerca.

Eccezioni

Nell'insieme non è presente alcuna tabella con il nome specificato.

Esempio

Nell'esempio seguente vengono usati i Contains metodi e CanRemove per verificare se esiste una tabella denominata e può essere rimossa. In tal caso, il Remove metodo viene chiamato per rimuovere la tabella.

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

Commenti

L'evento CollectionChanged si verifica quando una tabella viene rimossa correttamente.

Per determinare se esiste una tabella specificata e può essere rimossa prima di richiamare Remove, usare i Contains metodi e CanRemove .

Vedi anche

Si applica a

Remove(DataTable)

Rimuove l'oggetto DataTable specificato dalla raccolta.

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)

Parametri

table
DataTable

Oggetto DataTable da rimuovere.

Eccezioni

Il valore specificato per la tabella è null.

La tabella non appartiene a questo insieme.

-oppure-

La tabella fa parte di una relazione.

Esempio

Nell'esempio seguente viene usato il CanRemove metodo per verificare se ogni tabella può essere rimossa da un DataSetoggetto . In tal caso, il Remove metodo viene chiamato per rimuovere la tabella.

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

Commenti

L'evento CollectionChanged si verifica quando una tabella viene rimossa correttamente.

Per determinare se esiste una tabella specificata e può essere rimossa prima di richiamare Remove, usare i Contains metodi e CanRemove .

Vedi anche

Si applica a

Remove(String)

Rimuove dalla raccolta l'oggetto DataTable con il nome specificato.

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

Parametri

name
String

Nome dell'oggetto DataTable da rimuovere.

Eccezioni

Nell'insieme non è presente alcuna tabella con il nome specificato.

Esempio

Nell'esempio seguente vengono usati i Contains metodi e CanRemove per verificare se esiste una tabella denominata e può essere rimossa. In tal caso, il Remove metodo viene chiamato per rimuovere la tabella.

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

Commenti

L'evento CollectionChanged si verifica quando una tabella viene rimossa correttamente.

Per determinare se esiste una tabella specificata e può essere rimossa prima di richiamare Remove, usare i Contains metodi e CanRemove .

Vedi anche

Si applica a