DataColumnCollection.Remove Метод

Определение

Удаляет объект DataColumn из коллекции.Removes a DataColumn object from the collection.

Перегрузки

Remove(DataColumn)

Удаляет заданный объект DataColumn из коллекции.Removes the specified DataColumn object from the collection.

Remove(String)

Удаляет объект DataColumn с указанным именем из коллекции.Removes the DataColumn object that has the specified name from the collection.

Remove(DataColumn)

Удаляет заданный объект DataColumn из коллекции.Removes the specified DataColumn object from the collection.

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.The DataColumn to remove.

Исключения

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

Столбец не принадлежит этой коллекции.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 uses the Contains method to determine whether a named column exists. В этом случае свойство Item[String] возвращает столбец.If so, the Item[String] property returns the column. Затем метод CanRemove проверяет, можно ли удалить столбец. в этом случае метод Remove удаляет его.The CanRemove method then checks whether the column can be removed; if so, the Remove method removes it.

   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.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

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

Remove(String)

Удаляет объект DataColumn с указанным именем из коллекции.Removes the DataColumn object that has the specified name from the collection.

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

Параметры

name
String

Имя удаляемого столбца.The name of the column to remove.

Исключения

Коллекция не содержит столбец с указанным именем.The collection does not have a column with the specified name.

Примеры

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

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.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

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

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