ObjectDataSourceView.ExecuteUpdate Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Provede operaci aktualizace voláním metody, která je identifikována UpdateMethod vlastností a pomocí všech parametrů, které jsou zadány keysv , valuesnebo oldValues kolekce.
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 IntegerParametry
- keys
- IDictionary
Primární IDictionary klíče, které se mají použít s UpdateMethod vlastností k provedení operace aktualizace databáze. Pokud k metodě nejsou přidružené žádné klíče, předejte null.
- values
- IDictionary
Hodnota IDictionary , která se má použít s UpdateMethod operací aktualizace databáze. Pokud nejsou k metodě přidruženy žádné parametry, předejte null.
- oldValues
- IDictionary
A IDictionary , který představuje původní hodnoty v podkladovém úložišti dat. Pokud nejsou k dotazu přidruženy žádné parametry, předejte null.
Návraty
Počet aktualizovaných řádků; nebo -1, pokud číslo není známé. Další informace najdete na webu Update().
Výjimky
Vlastnost CanInsert vrátí false.
oldValues je nebo je null prázdný a ConflictDetection je nastaven na CompareAllValueshodnotu .
Poznámky
Třída ObjectDataSourceView implementuje zděděnou ExecuteUpdate metodu pro aktualizaci dat pomocí obchodního objektu. Vývojáři stránek a autoři ovládacích prvků vázané na data nevolají metodu ExecuteUpdate přímo. Místo toho použijte veřejně vystavenou Update metodu.
Hodnoty obsažené v keys kolekcích se values vyhodnocují a slučují se všemi hodnotami obsaženými v kolekci UpdateParameters .
ConflictDetection Pokud je vlastnost nastavena na CompareAllValues hodnotu, hodnoty obsažené v oldValues kolekci jsou formátovány s OldValuesParameterFormatString vlastností a jsou také sloučeny.
Před provedením OnUpdating operace aktualizace se volá metoda pro vyvolání Updating události. Tuto událost můžete zpracovat, abyste prozkoumali hodnoty parametrů a před aktualizací provedli jakékoli předběžné zpracování. Chcete-li provést operaci aktualizace, ObjectDataSourceView používá reflexe k volání metody, která je identifikována UpdateMethod vlastností a všechny přidružené parametry v keys kolekci, a pak ji spustí. Po dokončení OnUpdated operace se volá metoda pro vyvolání Updated události. Tuto událost můžete zpracovat, abyste prozkoumali všechny vrácené hodnoty, kódy chyb a provedli jakékoli následné zpracování.
Další informace o vrácení počtu aktualizovaných řádků najdete v tématu Update.
