DataGridViewRowCollection.Add 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

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

오버로드

Add()	컬렉션에 새 행을 추가합니다.
Add(Int32)	컬렉션에 지정된 수의 새 행을 추가합니다.
Add(Object[])	새 행을 컬렉션에 추가하고 셀을 지정된 개체로 채웁니다.
Add(DataGridViewRow)	지정된 DataGridViewRow를 컬렉션에 추가합니다.

Add()

Source:

DataGridViewRowCollection.cs

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

public:
 virtual int Add();

public virtual int Add ();

abstract member Add : unit -> int
override this.Add : unit -> int

Public Overridable Function Add () As Integer

반환

Int32

새 행의 인덱스입니다.

예외

InvalidOperationException

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

• 컨트롤의 모든 셀 선택

• 선택 영역 지우기

또는

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

또는

DataSource 의 DataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

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

ArgumentException

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

설명

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

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

추가 정보

• DataGridView
• DataGridViewRow
• Windows Forms DataGridView 컨트롤의 크기 조정에 대한 모범 사례

Add(Int32)

Source:

DataGridViewRowCollection.cs

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

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에 추가할 행의 수입니다.

반환

Int32

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

예외

ArgumentOutOfRangeException

count 가 1보다 작습니다.

InvalidOperationException

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

• 컨트롤의 모든 셀 선택

• 선택 영역 지우기

또는

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

또는

DataSource 의 DataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

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

또는

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

설명

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

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

추가 정보

• DataGridView
• DataGridViewRow

Add(Object[])

Source:

DataGridViewRowCollection.cs

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

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의 셀을 채우는 가변 개체 수입니다.

반환

Int32

새 행의 인덱스입니다.

예외

ArgumentNullException

values이(가) null인 경우

InvalidOperationException

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

• 컨트롤의 모든 셀 선택

• 선택 영역 지우기

또는

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

또는

DataGridView의 VirtualMode 속성이 true로 설정됩니다.

또는

DataSource 의 DataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

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

또는

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

설명

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

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

추가 정보

• DataGridView
• DataGridViewRow

Add(DataGridViewRow)

Source:

DataGridViewRowCollection.cs

지정된 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입니다.

반환

Int32

새 DataGridViewRow의 인덱스입니다.

예외

InvalidOperationException

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

• 컨트롤의 모든 셀 선택

• 선택 영역 지우기

또는

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

또는

DataSource 의 DataGridView 속성이 null이 아닙니다.

또는

DataGridView 에 열이 없습니다.

또는

DataGridView 의 dataGridViewRow 속성이 null이 아닙니다.

또는

dataGridViewRow 에 Selected 의 true속성 값이 있습니다.

또는

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

ArgumentNullException

dataGridViewRow이(가) null인 경우

ArgumentException

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

설명

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

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

추가 정보

• DataGridView
• DataGridViewRow
• DataGridViewColumn
• CellTemplate
• Windows Forms DataGridView 컨트롤의 크기 조정에 대한 모범 사례