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ém keysobjektu , valuesa 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 -> 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 nejsou k dotazu přidruženy žádné klíče nebo pokud UpdateCommand vlastnost není parametrizovaný dotaz SQL, předejte null.

values
IDictionary

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

oldValues
IDictionary

Jedná se o IDictionary původní hodnoty v databázi. Pokud nejsou k dotazu přidruženy žádné parametry nebo pokud UpdateCommand vlastnost není parametrizovaný dotaz SQL, předejte null.

Návraty

Int32

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

Výjimky

InvalidOperationException

Nelze SqlDataSource navázat připojení k podkladovému zdroji dat.

nebo

Vlastnost ConflictDetection je nastavena CompareAllValues na hodnotu a nejsou předány žá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é 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 . Pokud je vlastnost nastavena ConflictDetection na CompareAllValues, hodnoty obsažené v oldValues kolekci jsou formátovány pomocí OldValuesParameterFormatString a 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, 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 se volá 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é