DataColumnCollection.Remove 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

从集合中移除 DataColumn 对象。

重载

Remove(DataColumn)	从集合中移除指定的 DataColumn 对象。
Remove(String)	从集合中移除具有指定名称的 DataColumn 对象。

Remove(DataColumn)

Source:

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)

Source:

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)