IBindingList.AddNew 方法

定義

新增一項物品到清單中。

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

傳回

新增的項目。

例外狀況

備註

此方法僅 AllowNew 在 為 時 true支援;否則 a NotSupportedException 被拋出。

實作此方法意味著 IBindingList 清單必須了解要加入清單的物件類型,並知道如何建立該類型的新實例。 例如,如果你有一組 myCustomer 物件,方法 AddNew 應該會新增一個物件 myCustomer 到清單中。

Note

如果此清單中的物件實作了介面 IEditableObject ,呼叫該 CancelEdit 方法應該丟棄物件,而不是在物件是用該 AddNew 方法建立時加入清單。 該物件應該只有在方法被呼叫時 IEditableObject.EndEdit 才會被加入清單。 因此,你必須仔細同步物件與清單。

當呼叫此方法時,你應該以帶有適當索引的枚舉事件來觸發ListChangedItemAdded事件。 新增的那一列處於一個狀態,按下控制鍵的 Esc DataGridView 可以移除新一列。 在該列第二次提及 ListChanged 事件 ItemAdded 時,表示該項目現在是正常列(非新狀態)。

適用於