SqlDataSourceView.ExecuteInsert(IDictionary) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.