DataColumnCollection.Remove Метод

Определение

Пространство имен:

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

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

Перегрузки

Имя	Описание
Remove(DataColumn)	Удаляет указанный DataColumn объект из коллекции.
Remove(String)	DataColumn Удаляет объект, имеющий указанное имя из коллекции.

Remove(DataColumn)

Исходный код:

DataColumnCollection.cs

Удаляет указанный 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 .

Исключения

ArgumentNullException

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

ArgumentException

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

-Или-

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

-Или-

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

Примеры

В следующем примере метод используется 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 происходит событие.

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

• Contains(String)
• CanRemove(DataColumn)
• Item[Int32]

Remove(String)

Исходный код:

DataColumnCollection.cs

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

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

Исключения

ArgumentException

В коллекции нет столбца с указанным именем.

Примеры

В следующем примере метод сначала используется 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 происходит событие.

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

• Contains(String)