DataColumnCollection.CanRemove(DataColumn) Methode

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Quelle:: DataColumnCollection.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public:
 bool CanRemove(System::Data::DataColumn ^ column);

public bool CanRemove (System.Data.DataColumn? column);

public bool CanRemove (System.Data.DataColumn column);

member this.CanRemove : System.Data.DataColumn -> bool

Public Function CanRemove (column As DataColumn) As Boolean

Parameter

column: DataColumn

Eine DataColumn in der Auflistung.

Gibt zurück

Boolean

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

Der column-Parameter ist null.
Die Spalte gehört nicht zu dieser Auflistung.
Die Spalte ist Teil einer Beziehung.
Der Ausdruck einer anderen Spalte ist von dieser Spalte abhängig.

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 zunächst die Contains -Methode verwendet, um zu bestimmen, ob eine bestimmte Spalte in der Auflistung gefunden wird. Falls gefunden, testet die CanRemove Methode, ob die Spalte entfernt werden kann. Wenn ja, wird die Spalte mit der Remove -Methode entfernt.

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

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

Hinweise

Die CanRemove -Methode führt mehrere Überprüfungen durch, bevor ein true - oder false -Ergebnis zurückgegeben wird. Dies umfasst Folgendes: 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 die Contains -Methode auch verwenden, um zu bestimmen, ob eine bestimmte Spalte vorhanden ist, bevor Sie versuchen, sie zu entfernen.

Gilt für:

Produkt	Versionen
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Teilen über