Sdílet prostřednictvím


ObjectDataSourceView.ExecuteInsert(IDictionary) Metoda

Definice

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.

Platí pro

Viz také