DataGridViewRowCollection.Insert 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

컬렉션에 하나 이상의 행을 삽입합니다.

오버로드

Insert(Int32, DataGridViewRow)	지정된 DataGridViewRow 를 컬렉션에 삽입합니다.
Insert(Int32, Int32)	지정된 행 수를 컬렉션의 지정된 위치에 삽입합니다.
Insert(Int32, Object[])	컬렉션의 지정된 위치에 행을 삽입하고 지정된 개체로 셀을 채웁니다.

Insert(Int32, DataGridViewRow)

지정된 DataGridViewRow 를 컬렉션에 삽입합니다.

public:
 virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);

public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);

abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unit

Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)

매개 변수

rowIndex

Int32

행을 삽입할 위치입니다.

dataGridViewRow

DataGridViewRow

DataGridViewRowCollection에 삽입할 DataGridViewRow입니다.

예외

ArgumentOutOfRangeException

rowIndex 가 0보다 작거나 컬렉션의 행 수보다 큽니다.

ArgumentNullException

dataGridViewRow이(가) null인 경우

InvalidOperationException

연결된 DataGridView 컨트롤이 일시적으로 새 행이 추가되지 않도록 하는 다음 작업 중 하나를 수행합니다.

• 컨트롤의 모든 셀을 선택합니다.

• 선택 영역 지우기.

또는

이 메서드는 다음 DataGridView 이벤트 중 하나의 처리기에서 호출됩니다.

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

또는

DataSource 의 DataGridView 속성이 null이 아닙니다.

또는

rowIndex 가 컬렉션의 행 수와 같고 AllowUserToAddRows 의 DataGridView 속성이 true로 설정되었습니다.

또는

DataGridView 에 열이 없습니다.

또는

dataGridViewRow의 DataGridView 속성이 null이 아닌 경우

또는

dataGridViewRow 에 Selected 의 true속성 값이 있습니다.

또는

이 작업에서는 고정되지 않은 행 뒤에 고정된 행을 삽입하거나 고정된 행 앞에 고정되지 않은 행을 삽입합니다.

ArgumentException

dataGridViewRow 에 컨트롤에 있는 열보다 많은 셀이 포함되어 있습니다.

설명

가능한 경우 메서드는 Insert(Int32, DataGridViewRow) 공유 행을 에 DataGridViewRowCollection추가합니다. 그렇지 않으면 새 행이 공유되지 않습니다. 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기를 조정하는 최선의 방법을 참조하세요.

컨트롤의 행은 새 행이 추가될 때 자동으로 정렬되지 않습니다. 새 행을 올바른 위치로 정렬하려면 이벤트 처리기에서 메서드를 DataGridView.RowsAdded 호출 DataGridView.Sort 합니다. 사용자가 셀을 DataGridView.Sort 수정할 때 이벤트 처리기에서 CellValueChanged 메서드를 호출하여 행을 정렬할 수도 있습니다.

추가 정보

• DataGridView
• DataGridViewRow

Insert(Int32, Int32)

지정된 행 수를 컬렉션의 지정된 위치에 삽입합니다.

public:
 virtual void Insert(int rowIndex, int count);

public virtual void Insert (int rowIndex, int count);

abstract member Insert : int * int -> unit
override this.Insert : int * int -> unit

Public Overridable Sub Insert (rowIndex As Integer, count As Integer)

매개 변수

rowIndex

Int32

행을 삽입할 위치입니다.

count

Int32

DataGridViewRowCollection에 삽입할 행 수입니다.

예외

ArgumentOutOfRangeException

rowIndex 가 0보다 작거나 컬렉션의 행 수보다 큽니다.

또는

count 가 1보다 작습니다.

InvalidOperationException

연결된 DataGridView 컨트롤이 일시적으로 새 행이 추가되지 않도록 하는 다음 작업 중 하나를 수행합니다.

• 컨트롤의 모든 셀을 선택합니다.

• 선택 영역 지우기.

또는

이 메서드는 다음 DataGridView 이벤트 중 하나의 처리기에서 호출됩니다.

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

또는

DataSource 의 DataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

rowIndex 가 컬렉션의 행 수와 같고 AllowUserToAddRows 의 DataGridView 속성이 true로 설정되었습니다.

또는

RowTemplate 속성에 의해 반환된 행에 컨트롤의 열 수보다 더 많은 셀이 있습니다.

또는

이 작업에서는 고정되지 않은 행 뒤에 고정된 행을 삽입하거나 고정된 행 앞에 고정되지 않은 행을 삽입합니다.

설명

메서드는 Insert(Int32, Int32) 의 를 기반으로 하는 행을 RowTemplateDataGridView추가합니다. 가능한 경우 새 행이 공유됩니다. 최상의 확장성을 위해 속성에 지정된 행을 RowTemplate 공유할 수 있는지 확인합니다. 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기를 조정하는 최선의 방법을 참조하세요.

컨트롤의 행은 새 행이 추가될 때 자동으로 정렬되지 않습니다. 새 행을 올바른 위치로 정렬하려면 이벤트 처리기에서 메서드를 DataGridView.RowsAdded 호출 DataGridView.Sort 합니다. 사용자가 셀을 DataGridView.Sort 수정할 때 이벤트 처리기에서 CellValueChanged 메서드를 호출하여 행을 정렬할 수도 있습니다.

추가 정보

• DataGridView
• DataGridViewRow

Insert(Int32, Object[])

컬렉션의 지정된 위치에 행을 삽입하고 지정된 개체로 셀을 채웁니다.

public:
 virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);

public virtual void Insert (int rowIndex, params object[] values);

abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unit

Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())

매개 변수

rowIndex

Int32

행을 삽입할 위치입니다.

values

Object[]

새 행의 셀을 채우는 가변 개체 수입니다.

예외

ArgumentOutOfRangeException

rowIndex 가 0보다 작거나 컬렉션의 행 수보다 큽니다.

ArgumentNullException

values이(가) null인 경우

InvalidOperationException

연결된 DataGridView 컨트롤이 일시적으로 새 행이 추가되지 않도록 하는 다음 작업 중 하나를 수행합니다.

• 컨트롤의 모든 셀을 선택합니다.

• 선택 영역 지우기.

또는

이 메서드는 다음 DataGridView 이벤트 중 하나의 처리기에서 호출됩니다.

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

또는

DataGridView의 VirtualMode 속성이 true로 설정됩니다.

또는

DataSource 의 DataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

rowIndex 가 컬렉션의 행 수와 같고 AllowUserToAddRows 의 DataGridView 속성이 true로 설정되었습니다.

또는

컨트롤의 DataGridView 속성에 의해 반환된 행의 RowTemplate 속성이 null이 아닙니다.

또는

이 작업에서는 고정되지 않은 행 뒤에 고정된 행을 삽입하거나 고정된 행 앞에 고정되지 않은 행을 삽입합니다.

ArgumentException

컨트롤의 RowTemplate 속성에 의해 반환된 행에 컨트롤의 열 수보다 더 많은 셀이 있습니다.

설명

메서드는 Insert(Int32, Object[]) 공유되지 않은 행을 에 DataGridViewRowCollection추가합니다.

컨트롤의 행은 새 행이 추가될 때 자동으로 정렬되지 않습니다. 새 행을 올바른 위치로 정렬하려면 이벤트 처리기에서 메서드를 DataGridView.RowsAdded 호출 DataGridView.Sort 합니다. 사용자가 셀을 DataGridView.Sort 수정할 때 이벤트 처리기에서 CellValueChanged 메서드를 호출하여 행을 정렬할 수도 있습니다.

추가 정보

• DataGridView
• DataGridViewRow