DataGridViewRowCollection.InsertCopy(Int32, Int32) 메서드

정의

지정된 위치의 행을 기반으로 컬렉션의 지정된 위치에 행을 삽입합니다.Inserts a row into the collection at the specified position, based on the row at specified position.

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

새 행의 기반이 되는 행의 인덱스입니다.The index of the row on which to base the new row.

indexDestination
Int32

행을 삽입할 위치입니다.The position at which to insert the row.

예외

indexSource가 0보다 작거나 컬렉션의 행 수에서 1을 뺀 값보다 큰 경우indexSource is less than zero or greater than the number of rows in the collection minus one.

또는-or- indexDestination가 0보다 작거나 컬렉션의 행 수보다 큰 경우indexDestination is less than zero or greater than the number of rows in the collection.

연결된 DataGridView 컨트롤에서 임시로 새 행을 추가하지 못하게 하는 다음 작업 중 하나를 수행하고 있는 경우The associated DataGridView control is performing one of the following actions that temporarily prevents new rows from being added: - 컨트롤의 셀을 모두 선택합니다.- Selecting all cells in the control.

- 선택을 취소합니다.- Clearing the selection.

또는-or- 이 메서드는 다음 DataGridView 이벤트 중 하나의 처리기에서 호출됩니다.This method is being called from a handler for one of the following DataGridView events:

또는-or- indexDestination 이 컬렉션의 행 수와 같고 AllowUserToAddRowstrue입니다.indexDestination is equal to the number of rows in the collection and AllowUserToAddRows is true.

또는-or- 이 작업에서는 고정되지 않은 행 뒤에 고정된 행을 삽입하거나 고정된 행 앞에 고정되지 않은 행을 삽입합니다.This operation would insert a frozen row after unfrozen rows or an unfrozen row before frozen rows.

설명

이 메서드가 새 행에서 지정 된 인덱스에 할당 된 indexDestination 매개 변수 및 모든 후속 행에 대 한 인덱스 씩 증가 합니다.This method assigns the new row the index specified in the indexDestination parameter and increments the indexes for all subsequent rows. InheritedStyle 새 속성 DataGridViewRow 에 동일한 값을 InheritedStyleDataGridViewRow 에 배치 indexSource.The InheritedStyle property of the new DataGridViewRow has the same values as the InheritedStyle of the DataGridViewRow positioned at indexSource. 합니다 InsertCopy 공유 행을 추가 하는 메서드는 DataGridViewRowCollection가능한 경우.The InsertCopy method adds a shared row to the DataGridViewRowCollection, if possible. 그렇지 않으면 새 행이 공유 없습니다.Otherwise, the new row is unshared. 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정에 대 한 모범 사례합니다.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

컨트롤의 행은 새 행을 추가할 때 자동으로 정렬 되지 않습니다.Rows in the control are not automatically sorted when new rows are added. 를 올바른 위치에 새 행을 정렬 하려면 호출을 DataGridView.Sort 의 메서드를 DataGridView.RowsAdded 이벤트 처리기입니다.To sort new rows into their correct position, call the DataGridView.Sort method in a DataGridView.RowsAdded event handler. 호출할 수도 있습니다는 DataGridView.Sort 의 메서드는 CellValueChanged 행을 정렬 하는 사용자가 셀을 수정할 때 이벤트 처리기입니다.You might also want to call the DataGridView.Sort method in a CellValueChanged event handler to sort the rows when the user modifies a cell.

적용 대상

추가 정보