DataTableCollection.Remove Metoda

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Usuwa określony DataTable obiekt z kolekcji.

Przeciążenia

Remove(String, String)	DataTable Usuwa obiekt o określonej nazwie z kolekcji.
Remove(DataTable)	Usuwa określony DataTable obiekt z kolekcji.
Remove(String)	DataTable Usuwa obiekt o określonej nazwie z kolekcji.

Remove(String, String)

Źródło:

DataTableCollection.cs

DataTable Usuwa obiekt o określonej nazwie z kolekcji.

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)

Parametry

name

String

Nazwa DataTable obiektu do usunięcia.

tableNamespace

String

Nazwa DataTable przestrzeni nazw do wyszukania.

Wyjątki

ArgumentException

Kolekcja nie ma tabeli o określonej nazwie.

Przykłady

W poniższym przykładzie użyto Contains metod i CanRemove do przetestowania, czy istnieje nazwana tabela i można ją usunąć. Jeśli tak, metoda jest wywoływana Remove w celu usunięcia tabeli.

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

Uwagi

Zdarzenie CollectionChanged występuje po pomyślnym usunięciu tabeli.

Aby określić, czy dana tabela istnieje i może zostać usunięta przed wywołaniem Removemetody , użyj Contains metod i CanRemove .

Zobacz też

• IndexOf(DataTable)
• Contains(String)

Remove(DataTable)

Źródło:

DataTableCollection.cs

Usuwa określony DataTable obiekt z kolekcji.

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)

Parametry

table

DataTable

Element DataTable do usunięcia.

Wyjątki

ArgumentNullException

Wartość określona dla tabeli to null.

ArgumentException

Tabela nie należy do tej kolekcji.

-lub-

Tabela jest częścią relacji.

Przykłady

W poniższym przykładzie użyto CanRemove metody do przetestowania, czy każda tabela może zostać usunięta z klasy DataSet. Jeśli tak, metoda jest wywoływana Remove w celu usunięcia tabeli.

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

Uwagi

Zdarzenie CollectionChanged występuje po pomyślnym usunięciu tabeli.

Aby określić, czy dana tabela istnieje i może zostać usunięta przed wywołaniem Removemetody , użyj Contains metod i CanRemove .

Zobacz też

• IndexOf(DataTable)
• Contains(String)

Remove(String)

Źródło:

DataTableCollection.cs

DataTable Usuwa obiekt o określonej nazwie z kolekcji.

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

public void Remove (string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

Parametry

name

String

Nazwa DataTable obiektu do usunięcia.

Wyjątki

ArgumentException

Kolekcja nie ma tabeli o określonej nazwie.

Przykłady

W poniższym przykładzie użyto Contains metod i CanRemove do przetestowania, czy istnieje nazwana tabela i można ją usunąć. Jeśli tak, metoda jest wywoływana Remove w celu usunięcia tabeli.

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

Uwagi

Zdarzenie CollectionChanged występuje po pomyślnym usunięciu tabeli.

Aby określić, czy dana tabela istnieje i może zostać usunięta przed wywołaniem Removemetody , użyj Contains metod i CanRemove .

Zobacz też

• IndexOf(DataTable)
• Contains(String)