SqlDataSourceView.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í pomocí InsertCommand řetězce SQL, všech parametrů zadaných v InsertParameters kolekci a hodnot, které jsou v zadané values kolekci.
protected:
override int ExecuteInsert(System::Collections::IDictionary ^ values);protected override int ExecuteInsert(System.Collections.IDictionary values);override this.ExecuteInsert : System.Collections.IDictionary -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParametry
- values
- IDictionary
Hodnota IDictionary použitá s InsertCommand vlastností k provedení operace vložení databáze. Pokud nejsou k dotazu přidruženy žádné parametry nebo pokud InsertCommand vlastnost není parametrizovaný dotaz SQL, předejte null.
Návraty
Hodnota, která představuje počet řádků vložených do podkladové databáze.
Výjimky
Nelze SqlDataSource navázat připojení k podkladovému zdroji dat.
Aktuální uživatel nemá správná oprávnění k získání přístupu k databázi.
Vlastnost CanInsert je false.
Poznámky
Třída SqlDataSourceView implementuje zděděnou ExecuteInsert metodu pro vložení dat do databáze. 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 operace vložení se volá metoda pro vyvolání Inserting události. Tuto událost můžete zpracovat, abyste prozkoumali hodnoty parametrů a před vložením provedli jakékoli předběžné zpracování.
Aby bylo možné provést operaci vložení, SqlDataSourceView objekt vytvoří DbCommand objekt pomocí InsertCommand textu a všech přidružených InsertParameters vlastností a potom objekt spustí DbCommand proti podkladové databázi. Po dokončení OnInserted vložení se volá metoda pro vyvolání Inserted události. Tuto událost můžete zpracovat, abyste prozkoumali všechny návratové hodnoty a kódy chyb a provedli jakékoli následné zpracování.
