DataTableCollection.Remove Methode

Definitie

Naamruimte:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee verwijdert u een opgegeven DataTable object uit de verzameling.

Overloads

Name	Description
Remove(String, String)	Hiermee verwijdert u het DataTable object met de opgegeven naam uit de verzameling.
Remove(DataTable)	Hiermee verwijdert u het opgegeven DataTable object uit de verzameling.
Remove(String)	Hiermee verwijdert u het DataTable object met de opgegeven naam uit de verzameling.

Remove(String, String)

Hiermee verwijdert u het DataTable object met de opgegeven naam uit de verzameling.

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)

Parameters

name: String

De naam van het DataTable object dat u wilt verwijderen.

tableNamespace: String

De naam van de DataTable naamruimte waarin moet worden gezocht.

Uitzonderingen

ArgumentException

De verzameling heeft geen tabel met de opgegeven naam.

Voorbeelden

In het volgende voorbeeld worden de Contains en CanRemove methoden gebruikt om te testen of een benoemde tabel bestaat en kan worden verwijderd. Zo ja, dan wordt de Remove methode aangeroepen om de tabel te verwijderen.

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

Opmerkingen

De CollectionChanged gebeurtenis treedt op wanneer een tabel is verwijderd.

Als u wilt bepalen of een bepaalde tabel bestaat en kan worden verwijderd voordat u aanroept Remove, gebruikt u de Contains en de CanRemove methoden.

Zie ook

Van toepassing op

Remove(DataTable)

Hiermee verwijdert u het opgegeven DataTable object uit de verzameling.

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)

Parameters

table: DataTable

De DataTable te verwijderen.

Uitzonderingen

ArgumentNullException

De opgegeven waarde voor de tabel is null.

ArgumentException

De tabel behoort niet tot deze verzameling.

– of –

De tabel maakt deel uit van een relatie.

Voorbeelden

In het volgende voorbeeld wordt de CanRemove methode gebruikt om te testen of elke tabel uit een DataSettabel kan worden verwijderd. Zo ja, dan wordt de Remove methode aangeroepen om de tabel te verwijderen.

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

Opmerkingen

De CollectionChanged gebeurtenis treedt op wanneer een tabel is verwijderd.

Als u wilt bepalen of een bepaalde tabel bestaat en kan worden verwijderd voordat u aanroept Remove, gebruikt u de Contains en de CanRemove methoden.

Zie ook

Van toepassing op

Remove(String)

Hiermee verwijdert u het DataTable object met de opgegeven naam uit de verzameling.

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

public void Remove(string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

Parameters

name: String

De naam van het DataTable object dat u wilt verwijderen.

Uitzonderingen

ArgumentException

De verzameling heeft geen tabel met de opgegeven naam.

Voorbeelden

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

Opmerkingen

De CollectionChanged gebeurtenis treedt op wanneer een tabel is verwijderd.

Als u wilt bepalen of een bepaalde tabel bestaat en kan worden verwijderd voordat u aanroept Remove, gebruikt u de Contains en de CanRemove methoden.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?