DataColumnCollection.Remove 方法

定義

命名空間:

System.Data

組件:

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)