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.

public:
 void Remove(System::Data::DataColumn ^ column);

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

member this.Remove : System.Data.DataColumn -> unit

Public Sub Remove (column As DataColumn)

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.

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);
    }
}

Private Sub TestAndRemove(ByVal colToRemove As DataColumn)
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    If columns.Contains(colToRemove.ColumnName) Then
       columns.Remove(colToRemove)
    End If
End Sub

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.

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 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.

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);
}

Private Sub RemoveColumnByName(columnName As String)

    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns

    If columns.Contains(columnName) Then 
        If columns.CanRemove(columns(columnName)) Then 
            columns.Remove(columnName)
        End If
    End If
 End Sub

Hinweise

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

Weitere Informationen

• Contains(String)