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šechny parametry zadané v kolekci InsertParameters a hodnoty, 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 hodnoty použitá InsertCommand s vlastností k provedení operace vložení databáze. Pokud k dotazu nejsou přidružené žádné parametry nebo pokud InsertCommand vlastnost není parametrizovaným dotazem SQL, předejte null.
Návraty
Hodnota, která představuje počet řádků vložených do podkladové databáze.
Výjimky
Objekt SqlDataSource nemůže 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ých na data nevolají metodu ExecuteInsert přímo, ale používají veřejně vystavenou Insert metodu.
Před provedením OnInserting operace 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 vložením.
Chcete-li provést operaci vložení, SqlDataSourceView objekt sestaví DbCommand objekt pomocí InsertCommand textu a všech přidružených InsertParametersDbCommand vlastností a pak spustí objekt proti podkladové databázi. Po dokončení OnInserted vložení je volána 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í.
