ObjectDataSourceView.ExecuteUpdate Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Voert een updatebewerking uit door de methode aan te roepen die wordt geïdentificeerd door de UpdateMethod eigenschap en met behulp van parameters die zijn opgegeven in de keys, valuesof oldValues verzamelingen.
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 -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParameters
- keys
- IDictionary
Een IDictionary van de primaire sleutels die u met de UpdateMethod eigenschap wilt gebruiken om de updatedatabasebewerking uit te voeren. Als er geen sleutels zijn gekoppeld aan de methode, geeft u deze door null.
- values
- IDictionary
Een IDictionary van de waarden die moeten worden gebruikt voor het UpdateMethod uitvoeren van de updatedatabasebewerking. Als er geen parameters zijn gekoppeld aan de methode, geeft u dit door null.
- oldValues
- IDictionary
Een IDictionary die de oorspronkelijke waarden in het onderliggende gegevensarchief vertegenwoordigt. Als er geen parameters zijn gekoppeld aan de query, geeft u deze door null.
Retouren
Het aantal rijen bijgewerkt; of -1, als het getal niet bekend is. Zie Update() voor meer informatie.
Uitzonderingen
De CanInsert eigenschap retourneert false.
oldValues is null of leeg en ConflictDetection is ingesteld op CompareAllValues.
Opmerkingen
De ObjectDataSourceView klasse implementeert de overgenomen ExecuteUpdate methode om gegevens bij te werken met behulp van een bedrijfsobject. Paginaontwikkelaars en auteurs van gegevensgebonden besturingselementen roepen de ExecuteUpdate methode niet rechtstreeks aan. Gebruik in plaats daarvan de openbaar weergegeven Update methode.
De waarden in de keys verzameling en values verzamelingen worden geëvalueerd en samengevoegd met waarden die zijn opgenomen in de UpdateParameters verzameling. Als de ConflictDetection eigenschap is ingesteld op de CompareAllValues waarde, worden de waarden in de oldValues verzameling opgemaakt met de OldValuesParameterFormatString eigenschap en worden ze ook samengevoegd.
Voordat de updatebewerking wordt uitgevoerd, wordt de OnUpdating methode aangeroepen om de Updating gebeurtenis te genereren. U kunt deze gebeurtenis afhandelen om de waarden van de parameters te onderzoeken en eventuele voorverwerkingen uit te voeren vóór een update. Als u een updatebewerking wilt uitvoeren, gebruikt de ObjectDataSourceView reflectie om de methode aan te roepen die wordt geïdentificeerd door de UpdateMethod eigenschap en eventuele bijbehorende parameters in de keys verzameling en voert deze vervolgens uit. Nadat de bewerking is voltooid, wordt de OnUpdated methode aangeroepen om de Updated gebeurtenis te genereren. U kunt deze gebeurtenis afhandelen om retourwaarden, foutcodes te onderzoeken en eventuele naverwerking uit te voeren.
Zie voor meer informatie over het retourneren van het aantal bijgewerkte Updaterijen.