SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) 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 pomocí UpdateCommand řetězce SQL, všech parametrů, které jsou v UpdateParameters kolekci, a hodnot, které jsou v zadaných keyskolekcích , valuesa 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

Primární IDictionary klíče, které se mají použít s UpdateCommand vlastností k provedení operace aktualizace databáze. Pokud k dotazu nejsou přidružené žádné klíče nebo pokud UpdateCommand vlastnost není parametrizovaným dotazem SQL, předejte null.

values: IDictionary

Hodnoty IDictionary , které se mají použít s UpdateCommand vlastností k provedení operace aktualizace databáze. Pokud k dotazu nejsou přidružené žádné parametry nebo pokud UpdateCommand parametr není parametrizovaný dotaz SQL, předejte null.

oldValues: IDictionary

Představuje IDictionary původní hodnoty v databázi. Pokud k dotazu nejsou přidružené žádné parametry nebo pokud UpdateCommand vlastnost není parametrizovaným dotazem SQL, předejte null.

Návraty

Int32

Hodnota, která představuje počet řádků aktualizovaných v podkladové databázi.

Výjimky

InvalidOperationException

Objekt SqlDataSource nemůže navázat připojení k podkladovému zdroji dat.

-nebo-

Vlastnost ConflictDetection je nastavena CompareAllValues na hodnotu a nepředávají se žádné oldValues parametry.

HttpException

Aktuální uživatel nemá správná oprávnění k získání přístupu k databázi.

NotSupportedException

Vlastnost CanUpdate je false.

Poznámky

Třída SqlDataSourceView implementuje zděděnou ExecuteUpdate metodu pro aktualizaci dat v databázi. 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 nastavená na CompareAllValueshodnotu , hodnoty obsažené v kolekci oldValues se naformátují pomocí OldValuesParameterFormatString a také se sloučí.

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 veškeré předběžné zpracování před aktualizací.

K provedení operace SqlDataSourceView sestaví DbCommand objekt pomocí UpdateCommand textu a všech přidružených UpdateParameters vlastností a pak spustí DbCommand objekt proti podkladové databázi. Po dokončení OnUpdated operace je volána metoda pro vyvolání Updated události. Tuto událost můžete zpracovat, abyste prozkoumali všechny návratové hodnoty a kódy chyb a provedli jakékoli následné zpracování.

Platí pro

Sdílet prostřednictvím