DataTableCollection.Remove Metod

Definition

Namnområde:: System.Data

Sammansättning:: System.Data.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Tar bort ett angivet DataTable objekt från samlingen.

Överlagringar

Name	Description
Remove(String, String)	Tar bort objektet DataTable med det angivna namnet från samlingen.
Remove(DataTable)	Tar bort det angivna DataTable objektet från samlingen.
Remove(String)	Tar bort objektet DataTable med det angivna namnet från samlingen.

Remove(String, String)

Tar bort objektet DataTable med det angivna namnet från samlingen.

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)

Parametrar

name: String

Namnet på det objekt som DataTable ska tas bort.

tableNamespace: String

Namnet på namnområdet som DataTable ska tittas i.

Undantag

ArgumentException

Samlingen har ingen tabell med det angivna namnet.

Exempel

I följande exempel används metoderna och CanRemove för att testa om en namngiven Contains tabell finns och kan tas bort. I så fall Remove anropas metoden för att ta bort tabellen.

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

Kommentarer

Händelsen CollectionChanged inträffar när en tabell har tagits bort.

Om du vill avgöra om en viss tabell finns och kan tas bort innan du anropar Removeanvänder Contains du metoderna och CanRemove .

Se även

Gäller för

Remove(DataTable)

Tar bort det angivna DataTable objektet från samlingen.

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)

Parametrar

table: DataTable

Att DataTable ta bort.

Undantag

ArgumentNullException

Värdet som anges för tabellen är null.

ArgumentException

Tabellen tillhör inte den här samlingen.

-eller-

Tabellen är en del av en relation.

Exempel

I följande exempel används CanRemove metoden för att testa om varje tabell kan tas bort från en DataSet. I så fall Remove anropas metoden för att ta bort tabellen.

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

Kommentarer

Händelsen CollectionChanged inträffar när en tabell har tagits bort.

Om du vill avgöra om en viss tabell finns och kan tas bort innan du anropar Removeanvänder Contains du metoderna och CanRemove .

Se även

Gäller för

Remove(String)

Tar bort objektet DataTable med det angivna namnet från samlingen.

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

public void Remove(string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

Parametrar

name: String

Namnet på det objekt som DataTable ska tas bort.

Undantag

ArgumentException

Samlingen har ingen tabell med det angivna namnet.

Exempel

I följande exempel används metoderna och CanRemove för att testa om en namngiven Contains tabell finns och kan tas bort. I så fall Remove anropas metoden för att ta bort tabellen.

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

Kommentarer

Händelsen CollectionChanged inträffar när en tabell har tagits bort.

Om du vill avgöra om en viss tabell finns och kan tas bort innan du anropar Removeanvänder Contains du metoderna och CanRemove .

Se även

Gäller för

Feedback

Var den här sidan till hjälp?