SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.

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

Parameter

keys
IDictionary

Ein IDictionary von Objekt- bzw. Zeilenschlüsselwerten für den zu löschenden ExecuteDelete(IDictionary, IDictionary)-Vorgang.

oldValues
IDictionary

Ein IDictionary mit Zeilenwerten, die nur dann ausgewertet werden, wenn die ConflictDetection-Eigenschaft auf den CompareAllValues-Wert festgelegt ist.

Gibt zurück

Int32

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

Ausnahmen

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

Die CanDelete-Eigenschaft ist false.

- oder -

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

Hinweise

Die SqlDataSourceView -Klasse implementiert die geerbte ExecuteDelete Methode, um Daten aus einer Datenbank zu löschen. Seitenentwickler und Autoren von datengebundenen Steuerelementen rufen die ExecuteDelete -Methode nicht direkt auf. Verwenden Sie stattdessen die öffentlich verfügbar gemachte Delete Methode.

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

Bevor der Löschvorgang ausgeführt wird, wird die OnDeleting -Methode aufgerufen, um das Ereignis auszulösen Deleting . Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und vor einem Löschen vorzuverarbeiten.

Um einen Löschvorgang auszuführen, erstellt das SqlDataSourceView -Objekt ein DbCommand -Objekt unter Verwendung des DeleteCommand Texts und aller zugeordneten DeleteParameters Eigenschaften 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 Ereignis auszulösen Deleted . Sie können dieses Ereignis behandeln, um Rückgabewerte und Fehlercodes zu untersuchen und eine nachbereitende Verarbeitung durchzuführen.

Gilt für:

Weitere Informationen