DataColumnCollection.Remove Метод

Определение

Удаляет объект DataColumn из коллекции.

Перегрузки

Remove(DataColumn)

Удаляет указанный объект DataColumn из коллекции.

Remove(String)

Удаляет объект DataColumn с указанным именем из коллекции.

Remove(DataColumn)

Удаляет указанный объект DataColumn из коллекции.

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)

Параметры

column
DataColumn

Объект DataColumn для удаления.

Исключения

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

Столбец не принадлежит этой коллекции.

-Или-

Столбец является частью отношения.

-Или-

Выражение другого столбца зависит от этого столбца.

Примеры

В следующем примере метод используется для Contains определения существования именованного столбца. Если да, Item[] свойство возвращает столбец. Затем CanRemove метод проверяет, можно ли удалить столбец. Если это так, Remove метод удаляет его.

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

Комментарии

Если коллекция успешно изменена путем добавления или удаления столбцов, CollectionChanged происходит событие .

См. также раздел

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

Remove(String)

Удаляет объект DataColumn с указанным именем из коллекции.

public:
 void Remove(System::String ^ name);
public void Remove (string name);
member this.Remove : string -> unit
Public Sub Remove (name As String)

Параметры

name
String

Имя удаляемого столбца.

Исключения

Коллекция не содержит столбец с указанным именем.

Примеры

В следующем примере сначала используется Contains метод , чтобы определить, найден ли определенный столбец в коллекции. Если он найден, метод проверяет, CanRemove можно ли удалить столбец. Если это так, столбец удаляется с помощью Remove метода .

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

Комментарии

Если коллекция успешно изменена путем добавления или удаления столбцов, CollectionChanged происходит событие .

См. также раздел

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