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 Forms 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.

추가 정보

적용 대상