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 フォーム 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 呼び出します。

こちらもご覧ください

適用対象