DataColumnCollection.Remove Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Entfernt ein DataColumn-Objekt aus der Auflistung.

Überlädt

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

Remove(DataColumn)

Quelle:

DataColumnCollection.cs

Entfernt das angegebene DataColumn-Objekt aus der Auflistung.

C#

public void Remove (System.Data.DataColumn column);

Parameter

column

DataColumn

Das zu entfernende DataColumn-Element.

Ausnahmen

ArgumentNullException

Der column-Parameter ist null.

ArgumentException

Die Spalte gehört nicht zu dieser Auflistung.

-Oder-

Die Spalte ist Teil einer Beziehung.

-Oder-

Der Ausdruck einer anderen Spalte ist von dieser Spalte abhängig.

Beispiele

Im folgenden Beispiel wird mithilfe der Contains -Methode ermittelt, ob eine benannte Spalte vorhanden ist. Wenn ja, gibt die Item[] -Eigenschaft die Spalte zurück. Die CanRemove -Methode überprüft dann, ob die Spalte entfernt werden kann. Wenn ja, entfernt die Remove -Methode sie.

C#

private void TestAndRemove(DataColumn colToRemove)
{
    DataColumnCollection columns;
    // Get the DataColumnCollection from a DataTable in a DataSet.
    columns = DataSet1.Tables["Orders"].Columns;

    if(columns.Contains(colToRemove.ColumnName))
    {
        columns.Remove(colToRemove);
    }
}

Hinweise

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wurde, tritt das CollectionChanged Ereignis auf.

Weitere Informationen

• Contains(String)
• CanRemove(DataColumn)
• Item[Int32]

Remove(String)

Quelle:

DataColumnCollection.cs

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

C#

public void Remove (string name);

Parameter

name

String

Der Name der zu entfernenden Spalte.

Ausnahmen

ArgumentException

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

Beispiele

Im folgenden Beispiel wird zunächst die Contains -Methode verwendet, um zu bestimmen, ob eine bestimmte Spalte in der Auflistung gefunden wird. Wenn sie gefunden wird, testet die CanRemove Methode, ob die Spalte entfernt werden kann. Wenn ja, wird die Spalte mit der Remove -Methode entfernt.

C#

private void RemoveColumnByName(string columnName)
{
    // Get the DataColumnCollection from a DataTable in a DataSet.
    DataColumnCollection columns =
        ds.Tables["Suppliers"].Columns;

    if(columns.Contains(columnName))
        if(columns.CanRemove(columns[columnName]))
            columns.Remove(columnName);
}

Hinweise

Wenn die Auflistung durch Hinzufügen oder Entfernen von Spalten erfolgreich geändert wurde, tritt das CollectionChanged Ereignis auf.

Weitere Informationen

• Contains(String)