IBindingList.AddNew 메서드

정의

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

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

반환

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

예외

AllowNewfalse입니다.AllowNew is false.

설명

경우에이 메서드는 지원 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.

참고

이 목록에 있는 개체를 구현 하는 경우는 IEditableObject 인터페이스를 호출 합니다 CancelEdit 메서드 개체를 삭제, 없습니다 사용 하 여 개체를 만들 때 목록에 추가 해야는 AddNew 메서드.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.

발생 시켜야 하면이 메서드를 호출 하는 경우는 ListChanged 이벤트는 ItemAdded 적절 한 인덱스를 포함 하는 열거형입니다.When this method is called, you should raise a ListChanged event with the ItemAdded enumeration carrying the appropriate index. 상태에서 추가 행이 위치에서 esc를 DataGridView 컨트롤을 새 행을 제거할 수 있습니다.The added row is in a state where hitting Esc on a DataGridView control can remove the new row. 발생 합니다 ListChanged 사용 하 여 이벤트를 ItemAdded 열거형이이 행에 두 번 항목 (새 상태)에 없는 일반 행 이제 임을 나타냅니다.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).

적용 대상