DataColumnCollection.Remove 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
從集合中移除一個 DataColumn 物件。
多載
| 名稱 | Description |
|---|---|
| Remove(DataColumn) |
從集合中移除指定的 DataColumn 物件。 |
| Remove(String) |
從集合中移除 DataColumn 擁有指定名稱的物件。 |
Remove(DataColumn)
從集合中移除指定的 DataColumn 物件。
public:
void Remove(System::Data::DataColumn ^ column);public void Remove(System.Data.DataColumn column);member this.Remove : System.Data.DataColumn -> unitPublic 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)
從集合中移除 DataColumn 擁有指定名稱的物件。
public:
void Remove(System::String ^ name);public void Remove(string name);member this.Remove : string -> unitPublic 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 就會發生。
