IBindingList.AddNew Metoda

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.ComponentModel.TypeConverter.dll

Přidá do seznamu novou položku.

public:
 System::Object ^ AddNew();

public object? AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Návraty

Object

Položka přidaná do seznamu.

Výjimky

NotSupportedException

AllowNew je false.

Poznámky

Tato metoda je podporována pouze v případě, NotSupportedException že AllowNew je true; v opačném případě je vyvolán.

Implementace této metody znamená, že IBindingList seznam musí rozumět typu objektů, které se mají přidat do seznamu, a musí rozumět tomu, jak vytvořit novou instanci tohoto typu. Pokud máte například kolekci myCustomer objektů, AddNew měla by metoda do seznamu přidat nový myCustomer objekt.

Poznámka

Pokud objekty v tomto seznamu implementují IEditableObject rozhraní, volání CancelEdit metody by mělo zahodit objekt, nikoli ho přidat do seznamu, když byl objekt vytvořen pomocí AddNew metody. Objekt by měl být přidán do seznamu pouze při zavolání IEditableObject.EndEdit metody. Proto je nutné pečlivě synchronizovat objekt a seznam.

Při zavolání této metody byste měli vyvolat ListChanged událost s výčtem ItemAdded , který nese příslušný index. Přidaný řádek je ve stavu, kdy stisknutím klávesy Esc u DataGridView ovládacího prvku můžete nový řádek odebrat. ListChanged Zvýšení události s ItemAdded výčtem podruhé na tomto řádku znamená, že položka je nyní normálním řádkem (není v novém stavu).