ObjectDataSourceView.ExecuteInsert(IDictionary) 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í.
Provede operaci vložení voláním metody obchodního objektu, která je identifikována InsertMethod vlastností pomocí zadané values kolekce.
protected:
override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert(System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer
Parametry
- values
- IDictionary
A IDictionary parametrů použitých s InsertMethod vlastností k provedení operace vložení. Pokud nejsou k metodě přidruženy žádné parametry, předejte null.
Návraty
Počet vložených řádků; v opačném případě -1, pokud číslo není známo. Další informace najdete na webu Insert.
Výjimky
Vlastnost CanInsert vrátí false.
values je nebo je null prázdný.
Poznámky
Třída ObjectDataSourceView implementuje zděděnou ExecuteInsert metodu pro vložení dat do podkladového úložiště dat pomocí obchodního objektu. Vývojáři stránek a autoři ovládacích prvků vázané na data nevolají metodu ExecuteInsert přímo. Místo toho použijte veřejně vystavenou Insert metodu.
Před provedením OnInserting vložení se volá metoda pro vyvolání Inserting události. Tuto událost můžete zpracovat, abyste prozkoumali hodnoty parametrů a provedli veškeré předběžné zpracování před Insert zavolání metody.
Chcete-li provést operaci vložení, ObjectDataSourceView ovládací prvek používá reflexi k volání metody, která je identifikována InsertMethod vlastností a všechny přidružené parametry, které jsou v values kolekci, a pak ji spustí. Po dokončení OnInserted operace se volá metoda pro vyvolání Inserted události. Tuto událost můžete zpracovat, abyste prozkoumali všechny vrácené hodnoty, kódy chyb a provedli jakékoli následné zpracování.
Další informace o vrácení počtu vložených řádků naleznete v tématu Insert.