共用方式為


DataColumnCollection.Remove 方法

定義

從集合中移除 DataColumn 物件。

多載

Remove(DataColumn)

從集合中移除指定的 DataColumn 物件。

Remove(String)

從集合移除具有指定名稱的 DataColumn 物件。

Remove(DataColumn)

來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs
來源:
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

例外狀況

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)

來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs
來源:
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

要移除的資料行名稱。

例外狀況

集合不具有含有指定名稱的資料行。

範例

下列範例會先使用 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 發生此事件。

另請參閱

適用於