SqlDataSourceView.ExecuteDelete(IDictionary, 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 borttagningsåtgärd med hjälp av SQL-strängen DeleteCommand , alla parametrar som anges i DeleteParameters samlingen och de värden som finns i angivna keys och oldValues samlingar.
protected:
override int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteDelete(System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);
override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer
Parametrar
- keys
- IDictionary
En IDictionary av objekt- eller radnyckelvärden för åtgärden som ExecuteDelete(IDictionary, IDictionary) ska tas bort.
- oldValues
- IDictionary
En IDictionary som innehåller radvärden som endast utvärderas om ConflictDetection egenskapen är inställd på CompareAllValues värdet.
Returer
Ett värde som representerar antalet rader som tagits bort från den underliggande databasen.
Undantag
Det SqlDataSource går inte att upprätta en anslutning till den underliggande datakällan.
-eller-
Egenskapen ConflictDetection är inställd på värdet CompareAllValues och inga oldValues parametrar skickas.
Den aktuella användaren har inte rätt behörighet att komma åt databasen.
-eller-
Instansen av kontrollen är en AccessDataSource kontroll och åtkomst nekas till den sökväg som angetts DataFile för egenskapen.
Egenskapen CanDelete är false.
-eller-
En relativ sökväg för designtid mappades inte korrekt av designern innan en instans av AccessDataSource kontrollen användes.
Kommentarer
Klassen SqlDataSourceView implementerar den ärvda ExecuteDelete metoden för att ta bort data från en databas. Sidutvecklare och databundna kontrollförfattare anropar ExecuteDelete inte metoden direkt. Använd i stället den offentligt exponerade Delete metoden.
Värdena som finns i keys samlingen utvärderas och sammanfogas med alla värden som ingår i DeleteParameters samlingen. Om egenskapen ConflictDetection är inställd på CompareAllValues värdet formateras de värden som finns i oldValues samlingen med OldValuesParameterFormatString egenskapen och sammanfogas också.
Innan borttagningsåtgärden OnDeleting utförs anropas metoden för att skapa Deleting 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 borttagning.
För att utföra en borttagningsåtgärd SqlDataSourceView skapar objektet ett DbCommand objekt med hjälp av DeleteCommand texten och eventuella associerade DeleteParameters egenskaper och kör DbCommand sedan objektet mot den underliggande databasen. När borttagningen har slutförts anropas OnDeleted metoden för att skapa Deleted 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.