ObjectDataSourceView.ExecuteUpdate 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 uppdateringsåtgärd genom att anropa den metod som identifieras av UpdateMethod egenskapen och använda parametrar som anges i keys, valueseller oldValues samlingarna.
protected:
override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteUpdate(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer
Parametrar
- keys
- IDictionary
En IDictionary av de primära nycklar som ska användas med UpdateMethod egenskapen för att utföra uppdateringsdatabasåtgärden. Om det inte finns några nycklar associerade med metoden skickar du null.
- values
- IDictionary
Ett IDictionary värde som ska användas med UpdateMethod för att utföra uppdateringsdatabasåtgärden. Om det inte finns några parametrar som är associerade med metoden skickar du null.
- oldValues
- IDictionary
En IDictionary som representerar de ursprungliga värdena i det underliggande datalagret. Om det inte finns några parametrar som är associerade med frågan skickar du null.
Returer
Antalet rader har uppdaterats. eller -1, om talet inte är känt. Mer information finns i Update().
Undantag
Egenskapen CanInsert returnerar false.
oldValues är null eller tom och ConflictDetection är inställt på CompareAllValues.
Kommentarer
Klassen ObjectDataSourceView implementerar den ärvda ExecuteUpdate metoden för att uppdatera data med hjälp av ett affärsobjekt. Sidutvecklare och databundna kontrollförfattare anropar ExecuteUpdate inte metoden direkt. Använd i stället den offentligt exponerade Update metoden.
Värdena som finns i samlingarna keys och values utvärderas och sammanfogas med alla värden som ingår i UpdateParameters 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 uppdateringsåtgärden OnUpdating utförs anropas metoden för att skapa Updating 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 uppdatering. För att utföra en uppdateringsåtgärd ObjectDataSourceView använder reflektionen för att anropa den metod som identifieras av UpdateMethod egenskapen och eventuella associerade parametrar i keys samlingen och kör den sedan. När åtgärden har slutförts anropas OnUpdated metoden för att skapa Updated händelsen. Du kan hantera den här händelsen för att undersöka eventuella returvärden, felkoder och utföra eventuell efterbearbetning.
Mer information om hur du returnerar antalet uppdaterade rader finns i Update.