IBindingList.AddNew Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přidá do seznamu novou položku.
public:
System::Object ^ AddNew();public object? AddNew();public object AddNew();abstract member AddNew : unit -> objPublic Function AddNew () As ObjectNávraty
Položka přidaná do seznamu.
Výjimky
AllowNew je false.
Poznámky
Tato metoda je podporována pouze v případěAllowNew, true že je NotSupportedException; v opačném případě je vyvolán.
Implementace této metody znamená, že IBindingList seznam musí pochopit typ objektů, které se mají přidat do seznamu, a musí pochopit, jak vytvořit novou instanci tohoto typu. Pokud máte například kolekci myCustomer objektů, AddNew měla by metoda přidat nový myCustomer objekt do seznamu.
Note
Pokud objekty v tomto seznamu implementují IEditableObject rozhraní, volání CancelEdit metody by mělo zahodit objekt, nikoli přidat do seznamu, když byl objekt vytvořen pomocí AddNew metody. Objekt by měl být přidán pouze do seznamu při IEditableObject.EndEdit zavolání metody. Proto je nutné objekt a seznam pečlivě synchronizovat.
Při zavolání této metody byste měli vyvolat ListChanged událost s ItemAdded výčtem, který má odpovídající index. Přidaný řádek je ve stavu, kdy stisknutím klávesy Esc na ovládacím DataGridView prvku můžete nový řádek odebrat. Vyvolání ListChanged události s výčtem ItemAdded podruhé na tomto řádku označuje, že položka je nyní normálním řádkem (ne v novém stavu).
