DataGridViewRowCollection.Add 메서드

정의

컬렉션에 하나 이상의 행을 추가합니다.

오버로드

Add()

컬렉션에 새 행을 추가합니다.

Add(Int32)

컬렉션에 지정된 수의 새 행을 추가합니다.

Add(Object[])

새 행을 컬렉션에 추가하고 셀을 지정된 개체로 채웁니다.

Add(DataGridViewRow)

지정된 DataGridViewRow를 컬렉션에 추가합니다.

Add()

컬렉션에 새 행을 추가합니다.

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

반환

새 행의 인덱스입니다.

예외

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

  • 컨트롤의 모든 셀 선택

  • 선택 영역 지우기

또는

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

또는

DataSourceDataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

이 작업에서는 고정되지 않은 행 뒤에 고정된 행을 추가합니다.

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

설명

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

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

추가 정보

적용 대상

Add(Int32)

컬렉션에 지정된 수의 새 행을 추가합니다.

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

매개 변수

count
Int32

DataGridViewRowCollection에 추가할 행의 수입니다.

반환

추가된 마지막 행의 인덱스입니다.

예외

count 가 1보다 작습니다.

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

  • 컨트롤의 모든 셀 선택

  • 선택 영역 지우기

또는

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

또는

DataSourceDataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

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

또는

이 작업에서는 고정되지 않은 행 뒤에 고정된 행을 추가합니다.

설명

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

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

추가 정보

적용 대상

Add(Object[])

새 행을 컬렉션에 추가하고 셀을 지정된 개체로 채웁니다.

public:
 virtual int Add(... cli::array <System::Object ^> ^ values);
public virtual int Add (params object[] values);
abstract member Add : obj[] -> int
override this.Add : obj[] -> int
Public Overridable Function Add (ParamArray values As Object()) As Integer

매개 변수

values
Object[]

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

반환

새 행의 인덱스입니다.

예외

values이(가) null인 경우

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

  • 컨트롤의 모든 셀 선택

  • 선택 영역 지우기

또는

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

또는

DataGridViewVirtualMode 속성이 true로 설정됩니다.

또는

DataSourceDataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

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

또는

이 작업에서는 고정되지 않은 행 뒤에 고정된 행을 추가합니다.

설명

메서드는 Add(Object[]) 공유되지 않은 행을 에 DataGridViewRowCollection추가합니다. 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기를 조정하는 최선의 방법을 참조하세요.

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

추가 정보

적용 대상

Add(DataGridViewRow)

지정된 DataGridViewRow를 컬렉션에 추가합니다.

public:
 virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> int
Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

매개 변수

dataGridViewRow
DataGridViewRow

DataGridViewRow에 추가할 DataGridViewRowCollection입니다.

반환

DataGridViewRow의 인덱스입니다.

예외

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

  • 컨트롤의 모든 셀 선택

  • 선택 영역 지우기

또는

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

또는

DataSourceDataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

DataGridViewdataGridViewRow 속성이 null이 아닙니다.

또는

dataGridViewRowSelectedtrue속성 값이 있습니다.

또는

이 작업에서는 고정되지 않은 행 뒤에 고정된 행을 추가합니다.

dataGridViewRow이(가) null인 경우

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

설명

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

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

추가 정보

적용 대상