DataGridViewRowCollection.AddCopies(Int32, Int32) 메서드


지정된 인덱스의 행을 기반으로 하는 컬렉션에 지정된 수의 행을 추가합니다.Adds the specified number of rows to the collection based on the row at the specified index.

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

매개 변수


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


DataGridViewRowCollection에 추가할 행의 수입니다.The number of rows to add to the DataGridViewRowCollection.


추가된 마지막 행의 인덱스입니다.The index of the last row that was added.


indexSource가 0보다 작거나 컨트롤의 행 수보다 크거나 같습니다.indexSource is less than zero or greater than or equal to the number of rows in the control.

-또는--or- count가 0보다 작은 경우count is less than zero.

연결된 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.


DataGridViewRowInheritedStyle 속성 값은 indexSource에 배치 된 DataGridViewRowInheritedStyle와 동일 합니다.The InheritedStyle property of the new DataGridViewRow has the same values as the InheritedStyle of the DataGridViewRow positioned at indexSource. AddCopies 메서드는 가능 하면 DataGridViewRowCollection에 공유 행을 추가 합니다.The AddCopies method adds shared rows to the DataGridViewRowCollection, if possible. 그렇지 않으면 새 행을 공유 해제 됩니다.Otherwise, the new rows are 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.RowsAdded 이벤트 처리기에서 DataGridView.Sort 메서드를 호출 합니다.To sort new rows into their correct position, call the DataGridView.Sort method in a DataGridView.RowsAdded event handler. CellValueChanged 이벤트 처리기에서 DataGridView.Sort 메서드를 호출 하 여 사용자가 셀을 수정할 때 행을 정렬할 수도 있습니다.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.

적용 대상

추가 정보