ObjectDataSourceView.ExecuteUpdate Metoda

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

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 v keyskolekcích , valuesnebo oldValues .

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

Parametry

keys: IDictionary

A IDictionary primárních klíčů, 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

A IDictionary hodnot, které se mají použít s UpdateMethod nástrojem k provedení operace aktualizace databáze. Pokud k metodě nejsou přidružené žádné parametry, předejte null.

oldValues: IDictionary

A IDictionary , který představuje původní hodnoty v podkladovém úložišti dat. Pokud k dotazu nejsou přidružené žádné parametry, předejte null.

Návraty

Int32

Počet aktualizovaných řádků; nebo -1, pokud číslo není známé. Další informace naleznete v tématu Update().

Výjimky

NotSupportedException

Vlastnost CanInsert vrátí false.

InvalidOperationException

oldValues je null nebo prázdný a ConflictDetection je nastavený na CompareAllValues.

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ých na data nevolají metodu ExecuteUpdate přímo, ale používají veřejně vystavenou Update metodu.

Hodnoty obsažené v keys kolekcích a values se vyhodnotí a sloučí se všemi hodnotami obsaženými v kolekci UpdateParameters . ConflictDetection Pokud je vlastnost nastavena CompareAllValues na 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 je volána metoda pro vyvolání Updating události. Tuto událost můžete zpracovat, abyste prozkoumali hodnoty parametrů a provedli jakékoli předběžné zpracování před aktualizací. K provedení operace ObjectDataSourceView aktualizace nástroj používá reflexi k volání metody, která je identifikována vlastností a všemi přidruženými UpdateMethod parametry v kolekci keys , a pak ji spustí. Po dokončení OnUpdated operace je volána metoda pro vyvolání Updated události. Tuto událost můžete zpracovat ke kontrole případných návratových hodnot a kódů chyb a následnému zpracování.

Další informace o vrácení počtu aktualizovaných řádků najdete v tématu Update.

Platí pro

Sdílet prostřednictvím