ObjectDataSourceView.ExecuteUpdate Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Frissítési műveletet hajt végre a tulajdonság által azonosított metódus meghívásával és a UpdateMethod , keysvagy values gyűjteményekben oldValuesmegadott paraméterek használatával.
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 IntegerParaméterek
- keys
- IDictionary
A IDictionary tulajdonsággal UpdateMethod együtt használandó elsődleges kulcsok egyike a frissítési adatbázis-művelet végrehajtásához. Ha a metódushoz nincsenek kulcsok társítva, adja át a elemet null.
- values
- IDictionary
A IDictionary frissítési adatbázis-művelet végrehajtásához használandó UpdateMethod értékek egyike. Ha a metódushoz nincsenek paraméterek társítva, adja át a elemet null.
- oldValues
- IDictionary
A IDictionary mögöttes adattár eredeti értékeit jelképező érték. Ha a lekérdezéshez nincsenek paraméterek társítva, adja át a következőt null: .
Válaszok
A frissített sorok száma; vagy -1, ha a szám nem ismert. További információért lásd Update().
Kivételek
A CanInsert tulajdonság visszaadja a következőt false: .
oldValues vagy null üres, és ConflictDetection a következőre CompareAllValuesvan állítva: .
Megjegyzések
Az ObjectDataSourceView osztály az örökölt metódust ExecuteUpdate implementálja az adatok üzleti objektum használatával történő frissítéséhez. A lapfejlesztők és az adathoz kötött vezérlők nem hívják meg közvetlenül a ExecuteUpdate metódust, hanem a nyilvánosan közzétett Update metódust használják.
A rendszer kiértékeli és keys egyesíti a values gyűjteményben található értékeket a gyűjtemény által UpdateParameters tartalmazott értékekkel. Ha a ConflictDetection tulajdonság az CompareAllValues értékre van állítva, a gyűjteményben oldValues található értékek a tulajdonsággal OldValuesParameterFormatString vannak formázva, és szintén egyesülnek.
A frissítési művelet végrehajtása előtt a rendszer meghívja a OnUpdating metódust az Updating esemény felemelésére. Ezt az eseményt kezelheti a paraméterek értékeinek vizsgálatához és a frissítés előtti előzetes feldolgozáshoz. A frissítési művelet végrehajtásához a rendszer tükröződés ObjectDataSourceView használatával meghívja a tulajdonság és a UpdateMethodkeys gyűjteményben lévő társított paraméterek által azonosított metódust, majd végrehajtja azt. A művelet befejezése után a rendszer meghívja a OnUpdated metódust az Updated esemény felemelésére. Ezt az eseményt kezelheti a visszatérési értékek, hibakódok vizsgálatához és a feldolgozás utáni műveletek végrehajtásához.
A frissített sorok számának visszaadásával kapcsolatos további információkért lásd: Update.
