DataGridViewColumnCollection.Remove 方法

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

從集合中移除資料行。

多載

Remove(String)

從集合移除具有指定名稱的資料行。
Remove(DataGridViewColumn)

從集合中移除指定的資料行。

Remove(String)

從集合移除具有指定名稱的資料行。

public:
 virtual void Remove(System::String ^ columnName);
public virtual void Remove (string columnName);
abstract member Remove : string -> unit
override this.Remove : string -> unit
Public Overridable Sub Remove (columnName As String)

參數

columnName
String

要刪除的資料行名稱。

例外狀況

ArgumentException

columnName 不符合集合中任何資料行的名稱。

ArgumentNullException

columnName 為 null。

InvalidOperationException

相關聯的 DataGridView 控制項正在執行下列其中一個動作，暫時阻止加入新的資料行：

  • 選取控制項中的所有儲存格。

  • 清除選取範圍。

  • 更新資料行 DisplayIndex 屬性值。

-或-

針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：

範例

下列程式碼範例說明此方法的使用方式。 如需詳細資訊，請參閱如何：從 Windows Forms DataGridView 控制項移除自動產生的資料行。

private void BindDataAndInitializeColumns()
{
    dataGridView1.AutoGenerateColumns = true;
    dataGridView1.DataSource = customersDataSet;
    dataGridView1.Columns.Remove("Fax");
    dataGridView1.Columns["CustomerID"].Visible = false;
}

Private Sub BindDataAndInitializeColumns()

    With dataGridView1
        .AutoGenerateColumns = True
        .DataSource = customersDataSet
        .Columns.Remove("Fax")
        .Columns("CustomerID").Visible = False
    End With

End Sub

備註

資料行的名稱是以 DataGridViewColumn.Name 屬性工作表示。

若要移除系結至資料來源時自動產生的資料行，請在事件處理常式中 DataGridView.DataBindingComplete 呼叫此方法。

另請參閱

適用於

Remove(DataGridViewColumn)

從集合中移除指定的資料行。

public:
 virtual void Remove(System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);
public virtual void Remove (System.Windows.Forms.DataGridViewColumn dataGridViewColumn);
abstract member Remove : System.Windows.Forms.DataGridViewColumn -> unit
override this.Remove : System.Windows.Forms.DataGridViewColumn -> unit
Public Overridable Sub Remove (dataGridViewColumn As DataGridViewColumn)

參數

dataGridViewColumn
DataGridViewColumn

要刪除的資料行。

例外狀況

ArgumentException

dataGridViewColumn 不存在於集合中。

ArgumentNullException

dataGridViewColumn 為 null。

InvalidOperationException

相關聯的 DataGridView 控制項正在執行下列其中一個動作，暫時阻止加入新的資料行：

  • 選取控制項中的所有儲存格。

  • 清除選取範圍。

  • 更新資料行 DisplayIndex 屬性值。

-或-

針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：

備註

若要移除系結至資料來源時自動產生的資料行，請在事件處理常式中 DataGridView.DataBindingComplete 呼叫此方法。

另請參閱

適用於