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 k metodě nejsou přidružené žádné parametry, předejte null
.
Návraty
Počet vložených řádků; v opačném případě hodnota -1, pokud číslo není známo. Další informace naleznete v tématu Insert.
Výjimky
Vlastnost CanInsert vrátí false
.
values
je null
nebo je 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ých na data nevolají metodu ExecuteInsert přímo, ale používají veřejně vystavenou Insert metodu.
Před provedením OnInserting vložení je volána metoda pro vyvolání Inserting události. Tuto událost můžete zpracovat k prozkoumání hodnot parametrů a provedení jakéhokoli předběžného zpracování před Insert zavoláním metody.
Chcete-li provést operaci vložení, ObjectDataSourceView ovládací prvek používá reflexi k volání metody, která je identifikována vlastností a všemi přidruženými InsertMethod parametry, které jsou v kolekci values
, a poté ji spustí. Po dokončení OnInserted operace je volána metoda pro vyvolání Inserted události. Tuto událost můžete zpracovat ke kontrole případných návratových hodnot a kódů chyb a následnému zpracování.
Další informace o vrácení počtu vložených řádků najdete v tématu Insert.