DataGridViewRowCollection.AddCopy(Int32) 메서드

정의

지정된 인덱스의 행을 기반으로 하는 새 행을 추가합니다.Adds a new row based on the row at the specified index.

public:
 virtual int AddCopy(int indexSource);
public virtual int AddCopy (int indexSource);
abstract member AddCopy : int -> int
override this.AddCopy : int -> int
Public Overridable Function AddCopy (indexSource As Integer) As Integer

매개 변수

indexSource
Int32

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

반환

새 행의 인덱스입니다.The index of the new row.

예외

indexSource가 0보다 작거나 컬렉션의 행 수보다 크거나 같은 경우indexSource is less than zero or greater than or equal to 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- DataSourceDataGridView 속성이 null이 아닌 경우The DataSource property of the DataGridView is not null.

또는-or- 이 작업에서는 고정되지 않은 행 뒤에 고정된 행을 추가합니다.This operation would add a frozen row after unfrozen rows.

설명

합니다 InheritedStyle 에 동일한 값이 새 행의 속성을 InheritedStyle 에 있는 행의 indexSource합니다.The InheritedStyle property of the new row has the same values as the InheritedStyle of the row positioned at indexSource. 합니다 AddCopy 공유 행을 추가 하는 메서드는 DataGridViewRowCollection가능한 경우.The AddCopy 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.

적용 대상

추가 정보