(0) exportieren Drucken
Alle erweitern

SqlDataSourceView.ExecuteDelete-Methode

Aktualisiert: November 2007

Führt mit der DeleteCommand-SQL-Zeichenfolge, allen in der DeleteParameters-Auflistung angegebenen Parametern sowie den Werten in der angegebenen keys-Auflistung und der angegebenen oldValues-Auflistung einen Löschvorgang aus.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

protected override int ExecuteDelete(
	IDictionary keys,
	IDictionary oldValues
)
protected int ExecuteDelete(
	IDictionary keys,
	IDictionary oldValues
)
protected override function ExecuteDelete(
	keys : IDictionary, 
	oldValues : IDictionary
) : int

Parameter

keys
Typ: System.Collections.IDictionary
Ein IDictionary von Objekt- bzw. Zeilenschlüsselwerten für den zu löschenden ExecuteDelete-Vorgang.
oldValues
Typ: System.Collections.IDictionary
Ein IDictionary mit Zeilenwerten, die nur dann ausgewertet werden, wenn die ConflictDetection-Eigenschaft auf den CompareAllValues-Wert festgelegt ist.

Rückgabewert

Typ: System.Int32
Ein Wert, der die Anzahl der Zeilen darstellt, die aus der zugrunde liegenden Datenbank gelöscht wurden.

AusnahmeBedingung
InvalidOperationException

Die SqlDataSource kann keine Verbindung mit der zugrunde liegenden Datenquelle herstellen.

– oder –

Die ConflictDetection-Eigenschaft wird auf den CompareAllValues-Wert festgelegt, und es werden keine oldValues-Parameter übergeben.

HttpException

Der aktuelle Benutzer verfügt nicht über die erforderlichen Berechtigungen für den Zugriff auf die Datenbank.

– oder –

Die Instanz des Steuerelements ist ein AccessDataSource-Steuerelement, und der Zugriff auf den für die DataFile-Eigenschaft angegebenen Pfad wird verweigert.

NotSupportedException

Der Wert der CanDelete-Eigenschaft ist false.

– oder –

Vor dem Verwenden einer Instanz des AccessDataSource-Steuerelements wurde ein relativer Pfad zur Entwurfszeit vom Designer nicht ordnungsgemäß zugeordnet.

Die SqlDataSourceView-Klasse implementiert die geerbte ExecuteDelete-Methode, um Daten aus einer Datenbank zu löschen. Entwickler von Seiten und Ersteller von datengebundenen Steuerelementen rufen die ExecuteDelete-Methode nicht direkt auf, sondern verwenden stattdessen die öffentlich verfügbare Delete-Methode.

Die in der keys-Auflistung enthaltenen Werte werden ausgewertet und mit allen in der DeleteParameters-Auflistung enthaltenen Werten zusammengeführt. Wenn die ConflictDetection-Eigenschaft auf den CompareAllValues-Wert festgelegt ist, werden die in der oldValues-Auflistung enthaltenen Werte mit der OldValuesParameterFormatString-Eigenschaft formatiert und ebenfalls zusammengeführt.

Vor dem Ausführen des Löschvorgangs wird die OnDeleting-Methode aufgerufen, um das Deleting-Ereignis auszulösen. Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und ggf. eine Vorverarbeitung vor einem Löschvorgang auszuführen.

Zum Ausführen eines Löschvorgangs erstellt das SqlDataSourceView-Objekt mithilfe des DeleteCommand-Texts und aller zugeordneten DeleteParameters-Eigenschaften ein DbCommand-Objekt und führt dann das DbCommand-Objekt für die zugrunde liegende Datenbank aus. Nach Abschluss des Löschvorgangs wird die OnDeleted-Methode aufgerufen, um das Deleted-Ereignis auszulösen. Sie können eine Ereignisbehandlung definieren, mit der Sie Rückgabewerte und Fehlercodes überprüfen und eine möglicherweise erforderliche Nachbearbeitung durchführen können.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft