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 DeleteParameters kolekci 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 klíče objektu nebo řádku pro ExecuteDelete(IDictionary, IDictionary) operaci, která se má odstranit.
- oldValues
- IDictionary
Hodnota IDictionary obsahující hodnoty řádků, které jsou vyhodnoceny pouze v případě ConflictDetection , ž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
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.
Aktuální uživatel nemá správná oprávnění pro přístup k databázi.
nebo
Instance ovládacího prvku je AccessDataSource ovládací prvek a přístup je odepřen k cestě určené pro DataFile vlastnost.
Vlastnost CanDelete je false.
nebo
Návrhář před použitím instance ovládacího prvku nenamapoval správně relativní cestu 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é na data nevolají metodu ExecuteDelete přímo. Místo toho použijte veřejně vystavenou Delete metodu.
Hodnoty obsažené v keys kolekci se vyhodnocují a slučují se všemi hodnotami, které kolekce obsahuje 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, abyste prozkoumali hodnoty parametrů a před odstraněním provedli jakékoli předběžné zpracování.
Aby bylo možné provést operaci odstranění, SqlDataSourceView objekt vytvoří DbCommand objekt pomocí DeleteCommand textu a všech přidružených DeleteParameters vlastností a potom objekt spustí DbCommand 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í.
