DataGridViewRowCollection.Add 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

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

오버로드

Name	Description
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

-또는-

의 속성이 DataSourceDataGridView 아닙니다 null.

-또는-

DataGridView 열이 없습니다.

-또는-

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

ArgumentException

속성에서 반환되는 행에는 컨트롤에 RowTemplate 있는 열보다 많은 셀이 있습니다.

설명

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

컨트롤의 행은 새 행이 추가될 때 자동으로 정렬되지 않습니다. 새 행을 올바른 위치로 정렬하려면 이벤트 처리기 DataGridView.Sort 에서 메서드를 DataGridView.RowsAdded 호출합니다. 사용자가 셀을 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

-또는-

의 속성이 DataSourceDataGridView 아닙니다 null.

-또는-

DataGridView 열이 없습니다.

-또는-

속성에서 반환되는 행에는 컨트롤에 RowTemplate 있는 열보다 많은 셀이 있습니다.

-또는-

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

설명

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

컨트롤의 행은 새 행이 추가될 때 자동으로 정렬되지 않습니다. 새 행을 올바른 위치로 정렬하려면 이벤트 처리기 DataGridView.Sort 에서 메서드를 DataGridView.RowsAdded 호출합니다. 사용자가 셀을 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

-또는-

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

-또는-

의 속성이 DataSourceDataGridView 아닙니다 null.

-또는-

DataGridView 열이 없습니다.

-또는-

속성에서 반환되는 행에는 컨트롤에 RowTemplate 있는 열보다 많은 셀이 있습니다.

-또는-

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

설명

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

컨트롤의 행은 새 행이 추가될 때 자동으로 정렬되지 않습니다. 새 행을 올바른 위치로 정렬하려면 이벤트 처리기 DataGridView.Sort 에서 메서드를 DataGridView.RowsAdded 호출합니다. 사용자가 셀을 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

-또는-

의 속성이 DataSourceDataGridView 아닙니다 null.

-또는-

DataGridView 열이 없습니다.

-또는-

의 속성이 DataGridViewdataGridViewRow 아닙니다 null.

-또는-

dataGridViewRow 의 속성 값이 Selectedtrue있습니다.

-또는-

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

ArgumentNullException

dataGridViewRow은 null입니다.

ArgumentException

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

설명

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

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

추가 정보

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