IBindingList.AddNew 方法

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

將新的項目加入至清單中。

public:
 System::Object ^ AddNew();

public object? AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

傳回

Object

加入此清單的項目。

例外狀況

NotSupportedException

AllowNew 為 false。

備註

只有在 是 true時AllowNew，才支援這個方法，NotSupportedException否則會擲回 。

實作這個方法表示 IBindingList 清單必須瞭解要新增至清單的物件類型，而且必須瞭解如何建立該類型的新實例。 例如，如果您有物件的集合 myCustomer ，方法 AddNew 應該會將新的 myCustomer 物件新增至清單。

注意

如果此清單中的物件實 IEditableObject 作 介面，則呼叫 CancelEdit 方法應該捨棄物件，而不是在使用 AddNew 方法建立物件時將其新增至清單。 只有在呼叫 方法時 IEditableObject.EndEdit ，才會將 物件新增至清單。 因此，您必須仔細同步對象和清單。

呼叫這個方法時，您應該使用具有適當索引的ItemAdded列舉引發 ListChanged 事件。 新增的數據列處於在控件上 DataGridView 按下 Esc 鍵可移除新數據列的狀態。 ListChanged在此數據列上以列舉引發事件ItemAdded，表示專案現在是一般數據列， (不是處於新狀態) 。