DataGridViewRowCollection.InsertCopy(Int32, Int32) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

DataGridViewRowCollection.cs

지정된 위치에 있는 행을 기준으로 컬렉션에 지정된 위치에 행을 삽입합니다.

public:
 virtual void InsertCopy(int indexSource, int indexDestination);

public virtual void InsertCopy(int indexSource, int indexDestination);

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

Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)

매개 변수

indexSource

Int32

새 행의 기준이 될 행의 인덱스입니다.

indexDestination

Int32

행을 삽입할 위치입니다.

예외

ArgumentOutOfRangeException

indexSource 가 0보다 작거나 컬렉션의 행 수에서 1을 뺀 값보다 큽니다.

-또는-

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

InvalidOperationException

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

• 컨트롤의 모든 셀 선택

• 선택 영역 지우기

-또는-

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-또는-

indexDestination 는 컬렉션의 행 수와 같으며 AllowUserToAddRowstrue.

-또는-

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

설명

이 메서드는 매개 변수에 지정된 인덱스를 새 행에 indexDestination 할당하고 모든 후속 행에 대한 인덱스를 증분합니다. InheritedStyle 새 DataGridViewRow 속성의 값은 위치에 indexSource있는 값과 InheritedStyleDataGridViewRow 같습니다. 가능한 경우 메서드는 InsertCopy 공유 행을 해당 행에 DataGridViewRowCollection추가합니다. 그렇지 않으면 새 행이 공유되지 않습니다. 자세한 내용은 Windows Forms DataGridView 컨트롤 크기 조정에 대한 모범 사례를 참조하세요.

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

추가 정보

• DataGridView
• DataGridViewRow