DataTableCollection.Remove Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Entfernt ein angegebenes DataTable-Objekt aus der Auflistung.

Überlädt

Remove(String, String)	Entfernt das DataTable-Objekt mit dem angegebenen Namen aus der Auflistung.
Remove(DataTable)	Entfernt das angegebene DataTable-Objekt aus der Auflistung.
Remove(String)	Entfernt das DataTable-Objekt mit dem angegebenen Namen aus der Auflistung.

Remove(String, String)

Quelle:

DataTableCollection.cs

Entfernt das DataTable-Objekt mit dem angegebenen Namen aus der Auflistung.

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)

Parameter

name

String

Der Name des zu entfernenden DataTable-Objekts.

tableNamespace

String

Der Name des zu durchsuchenden DataTable-Namespaces.

Ausnahmen

ArgumentException

Die Auflistung enthält keine Tabelle mit dem angegebenen Namen.

Beispiele

Im folgenden Beispiel werden die Contains Methoden und CanRemove verwendet, um zu testen, ob eine benannte Tabelle vorhanden ist und entfernt werden kann. Wenn dies der Grund ist, wird die Remove -Methode aufgerufen, um die Tabelle zu entfernen.

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

Hinweise

Das CollectionChanged Ereignis tritt auf, wenn eine Tabelle erfolgreich entfernt wurde.

Um zu bestimmen, ob eine bestimmte Tabelle vorhanden ist und entfernt werden kann, bevor Sie aufrufen Remove, verwenden Sie die Contains Methoden und CanRemove .

Weitere Informationen

• IndexOf(DataTable)
• Contains(String)

Remove(DataTable)

Quelle:

DataTableCollection.cs

Entfernt das angegebene DataTable-Objekt aus der Auflistung.

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)

Parameter

table

DataTable

Das zu entfernende DataTable-Element.

Ausnahmen

ArgumentNullException

Der für die Tabelle angegebene Wert ist null.

ArgumentException

Die Tabelle gehört nicht zu dieser Auflistung.

- oder -

Die Tabelle ist Teil einer Beziehung.

Beispiele

Im folgenden Beispiel wird die CanRemove -Methode verwendet, um zu testen, ob jede Tabelle aus einem DataSetentfernt werden kann. Wenn dies der Grund ist, wird die Remove -Methode aufgerufen, um die Tabelle zu entfernen.

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

Hinweise

Das CollectionChanged Ereignis tritt auf, wenn eine Tabelle erfolgreich entfernt wurde.

Um zu bestimmen, ob eine bestimmte Tabelle vorhanden ist und entfernt werden kann, bevor Sie aufrufen Remove, verwenden Sie die Contains Methoden und CanRemove .

Weitere Informationen

• IndexOf(DataTable)
• Contains(String)

Remove(String)

Quelle:

DataTableCollection.cs

Entfernt das DataTable-Objekt mit dem angegebenen Namen aus der Auflistung.

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

public void Remove (string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

Parameter

name

String

Der Name des zu entfernenden DataTable-Objekts.

Ausnahmen

ArgumentException

Die Auflistung enthält keine Tabelle mit dem angegebenen Namen.

Beispiele

Im folgenden Beispiel werden die Contains Methoden und CanRemove verwendet, um zu testen, ob eine benannte Tabelle vorhanden ist und entfernt werden kann. Wenn dies der Grund ist, wird die Remove -Methode aufgerufen, um die Tabelle zu entfernen.

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

Hinweise

Das CollectionChanged Ereignis tritt auf, wenn eine Tabelle erfolgreich entfernt wurde.

Um zu bestimmen, ob eine bestimmte Tabelle vorhanden ist und entfernt werden kann, bevor Sie aufrufen Remove, verwenden Sie die Contains Methoden und CanRemove .

Weitere Informationen

• IndexOf(DataTable)
• Contains(String)