IBindingList.AddNew Method

Definition

새 항목을 목록에 추가 합니다.Adds a new item to the list.

public:
 System::Object ^ AddNew();
public object AddNew ();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object

Returns

Object

목록에 추가된 항목입니다.The item added to the list.

Exceptions

AllowNewfalse입니다.AllowNew is false.

Remarks

이 메서드는 AllowNew true경우에만 지원 됩니다. 그렇지 않으면 NotSupportedException throw 됩니다.This method is supported only if AllowNew is true; otherwise, a NotSupportedException is thrown.

이 메서드를 구현 하는 것은 IBindingList 목록에서 목록에 추가할 개체 형식을 이해 하 고 해당 형식의 새 인스턴스를 만드는 방법을 이해 하는 것을 의미 합니다.Implementing this method means that the IBindingList list must understand the type of objects to add to the list and must understand how to create a new instance of that type. 예를 들어 myCustomer 개체의 컬렉션이 있는 경우 AddNew 메서드는 새 myCustomer 개체를 목록에 추가 해야 합니다.For example, if you have a collection of myCustomer objects, the AddNew method should add a new myCustomer object to the list.

Note

이 목록의 개체가 IEditableObject 인터페이스를 구현 하는 경우에는 AddNew 메서드를 사용 하 여 개체를 만들 때 CancelEdit 메서드를 호출 하 여 개체를 삭제 하지 않고 개체를 목록에 추가 하지 않아야 합니다.If the objects in this list implement the IEditableObject interface, calling the CancelEdit method should discard an object, not add it to the list, when the object was created using the AddNew method. IEditableObject.EndEdit 메서드를 호출 하는 경우에만 개체를 목록에 추가 해야 합니다.The object should only be added to the list when the IEditableObject.EndEdit method is called. 따라서 개체와 목록을 신중 하 게 동기화 해야 합니다.Therefore, you must synchronize the object and the list carefully.

이 메서드를 호출 하면 적절 한 인덱스를 포함 하는 ItemAdded 열거형으로 ListChanged 이벤트를 발생 시켜야 합니다.When this method is called, you should raise a ListChanged event with the ItemAdded enumeration carrying the appropriate index. 추가 된 행이 DataGridView 컨트롤의 Esc 키를 누르면 새 행이 제거 될 수 있습니다.The added row is in a state where hitting Esc on a DataGridView control can remove the new row. ItemAdded 열거를 사용 하 여 ListChanged 이벤트를이 행에 두 번째로 올리는 것은 항목이 새 상태가 아닌 일반 행 임을 나타냅니다.Raising the ListChanged event with the ItemAdded enumeration a second time on this row indicates that the item is now a normal row (not in new state).

Applies to