SqlDataSourceView.ExecuteInsert(IDictionary) Metod

Definition

Utför en infogningsåtgärd med hjälp av SQL-strängen InsertCommand , alla parametrar som anges i InsertParameters samlingen och de värden som finns i den angivna values samlingen.

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

Parametrar

values
IDictionary

Ett IDictionary värde som används med InsertCommand egenskapen för att utföra åtgärden infoga databas. Om det inte finns några parametrar som är associerade med frågan eller om egenskapen InsertCommand inte är en parameteriserad SQL-fråga skickar du null.

Returer

Ett värde som representerar antalet rader som infogats i den underliggande databasen.

Undantag

Det SqlDataSource går inte att upprätta en anslutning till den underliggande datakällan.

Den aktuella användaren har inte rätt behörighet för att få åtkomst till databasen.

Egenskapen CanInsert är false.

Kommentarer

Klassen SqlDataSourceView implementerar den ärvda ExecuteInsert metoden för att infoga data i en databas. Sidutvecklare och databundna kontrollförfattare anropar ExecuteInsert inte metoden direkt. Använd i stället den offentligt exponerade Insert metoden.

Innan infogningsåtgärden OnInserting utförs anropas metoden för att skapa Inserting händelsen. Du kan hantera den här händelsen för att undersöka parametrarnas värden och utföra eventuell förbearbetning före en infogning.

För att utföra en infogningsåtgärd SqlDataSourceView skapar objektet ett DbCommand objekt med hjälp av InsertCommand texten och eventuella associerade InsertParameters egenskaper och kör DbCommand sedan objektet mot den underliggande databasen. När infogningen har slutförts anropas OnInserted metoden för att skapa Inserted händelsen. Du kan hantera den här händelsen för att undersöka eventuella returvärden och felkoder och utföra eventuella efterbearbetningar.

Gäller för

Se även