DataGridViewColumnCollection.Remove メソッド

定義

列をコレクションから削除します。Removes a column from the collection.

オーバーロード

Remove(String)

指定した名前の列をコレクションから削除します。Removes the column with the specified name from the collection.

Remove(DataGridViewColumn)

指定した列をコレクションから削除します。Removes the specified column from the collection.

Remove(String)

指定した名前の列をコレクションから削除します。Removes the column with the specified name from the collection.

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

削除される列の名前。The name of the column to delete.

例外

columnName と一致する列名がコレクションに存在しません。columnName does not match the name of any column in the collection.

columnNamenullです。columnName is null.

関連付けられた DataGridView コントロールによって次のいずれかのアクションが実行されているため、一時的に新しい列が追加できない状態にあります。The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added: - コントロール内のすべてのセルを選択している。- Selecting all cells in the control.

- 選択範囲をクリアしている。- Clearing the selection.

- 列の DisplayIndex プロパティ値を更新している。- Updating column DisplayIndex property values.

- または --or- このメソッドが、次のいずれかに該当する DataGridView イベントのハンドラーから呼び出されています。This method is being called from a handler for one of the following DataGridView events:

次のコード例は、このメソッドの使用方法を示しています。The following code example illustrates the use of this method. 詳細については、「方法 :Windows フォーム DataGridView コントロールから自動生成した列を削除します。For more information, see How to: Remove Autogenerated Columns from a Windows Forms DataGridView Control.

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プロパティによって示されます。The name of a column is indicated by the DataGridViewColumn.Name property.

データソースへのバインド時に自動的に生成される列を削除するには、 DataGridView.DataBindingCompleteイベントハンドラーでこのメソッドを呼び出します。To remove a column that is automatically generated when binding to a data source, call this method in a DataGridView.DataBindingComplete event handler.

こちらもご覧ください

Remove(DataGridViewColumn)

指定した列をコレクションから削除します。Removes the specified column from the collection.

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

パラメーター

dataGridViewColumn
DataGridViewColumn

削除する列。The column to delete.

例外

dataGridViewColumn がコレクション内にありません。dataGridViewColumn is not in the collection.

dataGridViewColumnnullです。dataGridViewColumn is null.

関連付けられた DataGridView コントロールによって次のいずれかのアクションが実行されているため、一時的に新しい列が追加できない状態にあります。The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added: - コントロール内のすべてのセルを選択している。- Selecting all cells in the control.

- 選択範囲をクリアしている。- Clearing the selection.

- 列の DisplayIndex プロパティ値を更新している。- Updating column DisplayIndex property values.

- または --or- このメソッドが、次のいずれかに該当する DataGridView イベントのハンドラーから呼び出されています。This method is being called from a handler for one of the following DataGridView events:

注釈

データソースへのバインド時に自動的に生成される列を削除するには、 DataGridView.DataBindingCompleteイベントハンドラーでこのメソッドを呼び出します。To remove a column that is automatically generated when binding to a data source, call this method in a DataGridView.DataBindingComplete event handler.

こちらもご覧ください

適用対象