SqlDataSourceView.ExecuteInsert(IDictionary) Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

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 -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Parametry

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

Int32

Hodnota, která představuje počet řádků vložených do podkladové databáze.

Výjimky

InvalidOperationException

Objekt SqlDataSource nemůže navázat připojení k podkladovému zdroji dat.

HttpException

Aktuální uživatel nemá správná oprávnění k získání přístupu k databázi.

NotSupportedException

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í.

Platí pro

Viz také