Sdílet prostřednictvím

ObjectDataSourceView.ExecuteUpdate Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

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

Viz také