SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Metoda

  • Reference

Definice

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

Provede operaci odstranění pomocí DeleteCommand řetězce SQL, všech parametrů zadaných v kolekci DeleteParameters a hodnot, které jsou v zadaných keys a oldValues kolekcích.

protected:
 override int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteDelete (System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);
override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer

Parametry

keys
IDictionary

Hodnota IDictionary objektu nebo klíče řádku pro operaci, která ExecuteDelete(IDictionary, IDictionary) se má odstranit.

oldValues
IDictionary

Obsahuje IDictionary hodnoty řádků, které jsou vyhodnoceny pouze v ConflictDetection případě, že je vlastnost nastavena na CompareAllValues hodnotu.

Návraty

Int32

Hodnota, která představuje počet řádků odstraněných z podkladové databáze.

Výjimky

InvalidOperationException

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

-nebo-

Vlastnost ConflictDetection je nastavena na CompareAllValues hodnotu a nejsou předány žádné oldValues parametry.

HttpException

Aktuální uživatel nemá správná oprávnění pro přístup k databázi.

-nebo-

Instance ovládacího prvku je ovládací prvek AccessDataSource a přístup k cestě zadané pro DataFile vlastnost je odepřen.

NotSupportedException

Vlastnost CanDelete je false.

-nebo-

Před použitím instance ovládacího prvku nebyl návrhářem správně namapována relativní cesta v době návrhu AccessDataSource .

Poznámky

Třída SqlDataSourceView implementuje zděděnou ExecuteDelete metodu pro odstranění dat z databáze. Vývojáři stránek a autoři ovládacích prvků vázaných na data nevolají metodu ExecuteDelete přímo, ale používají veřejně vystavenou Delete metodu.

Hodnoty obsažené v kolekci keys se vyhodnotí a sloučí se všemi hodnotami obsaženými v kolekci DeleteParameters . ConflictDetection Pokud je vlastnost nastavena na CompareAllValues hodnotu, hodnoty obsažené v oldValues kolekci jsou formátovány s OldValuesParameterFormatString vlastností a jsou také sloučeny.

Před provedením OnDeleting operace odstranění je volána metoda pro vyvolání Deleting události. Tuto událost můžete zpracovat k prozkoumání hodnot parametrů a k provedení předběžného zpracování před odstraněním.

K provedení operace SqlDataSourceView odstranění objekt vytvoří DbCommand objekt pomocí DeleteCommand textu a všech přidružených DeleteParametersDbCommand vlastností a pak provede objekt proti podkladové databázi. Po dokončení OnDeleted operace odstranění je volána metoda pro vyvolání Deleted 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é