SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Metoda
Definice
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 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 -> intProtected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As IntegerParametry
- 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
Hodnota, která představuje počet řádků odstraněných z podkladové databáze.
Výjimky
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.
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.
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í.
