DataColumnCollection.CanRemove-Methode

Artikel
08/20/2007

Überprüft, ob eine bestimmte Spalte aus der Auflistung entfernt werden kann.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Function CanRemove ( _
    column As DataColumn _
) As Boolean
'Usage
Dim instance As DataColumnCollection
Dim column As DataColumn
Dim returnValue As Boolean

returnValue = instance.CanRemove(column)

public bool CanRemove (
    DataColumn column
)

public:
bool CanRemove (
    DataColumn^ column
)

public boolean CanRemove (
    DataColumn column
)

public function CanRemove (
    column : DataColumn
) : boolean

Parameter

column
Eine DataColumn in der Auflistung.

Rückgabewert

true, wenn die Spalte entfernt werden kann, andernfalls false.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der column-Parameter ist NULL (Nothing in Visual Basic).
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.

ArgumentNullException

Der column-Parameter ist NULL (Nothing in Visual Basic).

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.

Hinweise

Die CanRemove-Methode führt mehrere Prüfungen aus, bevor ein true-Ergebnis bzw. ein false-Ergebnis zurückgegeben wird. Dabei wird überprüft, ob die Spalte vorhanden ist, zur Tabelle gehört oder an einer Einschränkung oder Beziehung beteiligt ist.

Verwenden Sie die CanRemove-Methode, bevor Sie versuchen, eine Spalte aus einer Auflistung zu entfernen. Sie können mit der Contains-Methode auch bestimmen, ob eine bestimmte Spalte vorhanden ist, bevor Sie versuchen, diese zu entfernen.

Beispiel

Im folgenden Beispiel wird zunächst mit der Contains-Methode bestimmt, ob sich eine bestimmte Spalte in der Auflistung befindet. Wenn dies der Fall ist, überprüft die CanRemove-Methode, ob die Spalte entfernt werden kann. Trifft dies zu, wird die Spalte mithilfe der Remove-Methode entfernt.

Private Sub RemoveColumn( _
    columnName As String, table As DataTable)

    Dim columns As DataColumnCollection = table.Columns
    If columns.Contains(columnName) Then 
        If columns.CanRemove(columns(columnName)) Then 
           columns.Remove(columnName)
        End If
    End If
End Sub

private void RemoveColumn(string columnName, DataTable table)
{
    DataColumnCollection columns = table.Columns;
    if (columns.Contains(columnName))
        if (columns.CanRemove(columns[columnName]))
            columns.Remove(columnName);
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataColumnCollection-Klasse
DataColumnCollection-Member
System.Data-Namespace
Contains
Remove

Freigeben über