DataTableCollection.Remove Metodo

Definizione

Spazio dei nomi:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rimuove un oggetto specificato DataTable dall'insieme.

Overload

Nome	Descrizione
Remove(String, String)	Rimuove l'oggetto DataTable con il nome specificato dall'insieme.
Remove(DataTable)	Rimuove l'oggetto specificato DataTable dall'insieme.
Remove(String)	Rimuove l'oggetto DataTable con il nome specificato dall'insieme.

Remove(String, String)

Rimuove l'oggetto DataTable con il nome specificato dall'insieme.

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 DataTable spazio dei nomi da cercare.

Eccezioni

ArgumentException

La raccolta non dispone di una tabella con il nome specificato.

Esempio

Nell'esempio seguente vengono utilizzati i Contains metodi e CanRemove per verificare se esiste una tabella denominata e può essere rimossa. In tal caso, viene chiamato il Remove metodo 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 una determinata tabella esiste e può essere rimossa prima di richiamare Remove, utilizzare i Contains metodi e CanRemove .

Vedi anche

Si applica a

Remove(DataTable)

Rimuove l'oggetto specificato DataTable dall'insieme.

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

ArgumentNullException

Il valore specificato per la tabella è null.

ArgumentException

La tabella non appartiene a questa raccolta.

oppure

La tabella fa parte di una relazione.

Esempio

Nell'esempio seguente viene utilizzato il CanRemove metodo per verificare se ogni tabella può essere rimossa da un oggetto DataSet. In tal caso, viene chiamato il Remove metodo 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 una determinata tabella esiste e può essere rimossa prima di richiamare Remove, utilizzare i Contains metodi e CanRemove .

Vedi anche

Si applica a

Remove(String)

Rimuove l'oggetto DataTable con il nome specificato dall'insieme.

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

ArgumentException

La raccolta non dispone di una tabella con il nome specificato.

Esempio

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 una determinata tabella esiste e può essere rimossa prima di richiamare Remove, utilizzare i Contains metodi e CanRemove .

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?