DataColumnCollection.CanRemove(DataColumn) Метод

Определение

Пространство имен:
System.Data
Сборки:
System.Data.dll, netstandard.dll, System.Data.Common.dll

Проверяет, может ли быть удален из коллекции указанный столбец.Checks whether a specific column can be removed from the collection.

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

Параметры

column
DataColumn

Объект DataColumn в коллекции.A DataColumn in the collection.

Возвращаемое значение

Boolean

true если столбец можно удалитьtrue if the column can be removed. false если,false if, – Параметр column имеет значение null.- The column parameter is null.

– Столбец не принадлежит этой коллекции.- The column does not belong to this collection.

– Столбец является частью отношения.- The column is part of a relationship.

– Выражение другого столбца зависит от этого столбца.- Another column's expression depends on this column.

Исключения

ArgumentNullException

Параметр column имеет значение null.The column parameter is null.

ArgumentException

Столбец не принадлежит этой коллекции.The column does not belong to this collection.

-или--or-

Столбец является частью отношения.The column is part of a relationship.

-или--or-

Выражение другого столбца зависит от этого столбца.Another column's expression depends on this column.

Примеры

В следующем примере сначала используется метод Contains, чтобы определить, найден ли определенный столбец в коллекции.The following example first uses the Contains method to determine whether a particular column is found in the collection. Если объект найден, CanRemove метод проверяет, можно ли удалить столбец.If found, the CanRemove method tests whether the column can be removed. Если это так, столбец удаляется с помощью метода Remove.If so, the column is removed with the Remove method.

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

Комментарии

Метод CanRemove выполняет несколько проверок перед возвратом результата true или false.The CanRemove method performs several checks before returning a true or false result. Сюда входят следующие: существует ли столбец, принадлежащий таблице или участвует в ограничении или связи.This includes the following: whether the column exists, belongs to the table, or is involved in a constraint or relation.

Используйте метод CanRemove, прежде чем пытаться удалить любой столбец из коллекции.Use the CanRemove method before you try to remove any column from a collection. Можно также использовать метод Contains, чтобы определить, существует ли определенный столбец, прежде чем пытаться его удалить.You can also use the Contains method to determine whether a particular column exists before you try to remove it.

Применяется к

Дополнительно