Sdílet prostřednictvím

SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metoda

Definice

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

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

Viz také