DataSourceView.ExecuteDelete(IDictionary, IDictionary) Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Führt einen Löschvorgang in der Liste der Daten aus, die das DataSourceView Objekt darstellt.

protected:
 virtual int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);

protected virtual int ExecuteDelete(System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);

abstract member ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int

Protected Overridable Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer

Parameter

keys

IDictionary

Eine IDictionary Von Objekt- oder Zeilentasten, die ExecuteDelete(IDictionary, IDictionary) vom Vorgang gelöscht werden sollen.

oldValues

IDictionary

Ein IDictionary Name/Wert-Paar, das Datenelemente und ihre ursprünglichen Werte darstellt.

Gibt zurück

Int32

Die Anzahl der Elemente, die aus dem zugrunde liegenden Datenspeicher gelöscht wurden.

Ausnahmen

NotSupportedException

Der ExecuteDelete(IDictionary, IDictionary) Vorgang wird von der DataSourceView.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse, die die Klasse erweitert, die DataSourceViewCanDelete Eigenschaft und die ExecuteDelete Methode außer Kraft setzen kann. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataSourceView Klasse bereitgestellt wird.

// The CsvDataSourceView does not currently
// permit deletion. You can modify or extend
// this sample to do so.
public override bool CanDelete {
    get {
        return false;
    }
}
protected override int ExecuteDelete(IDictionary keys, IDictionary values)
{
    throw new NotSupportedException();
}

' The CsvDataSourceView does not currently
' permit deletion. You can modify or extend
' this sample to do so.
Public Overrides ReadOnly Property CanDelete() As Boolean
   Get
      Return False
   End Get
End Property

Protected Overrides Function ExecuteDelete(keys As IDictionary, values As IDictionary) As Integer
   Throw New NotSupportedException()
End Function 'ExecuteDelete

Hinweise

Datengebundene Steuerelemente können bestimmen, ob der ExecuteDelete Vorgang von einem Datenquellensteuerelement unterstützt wird, indem das DataSourceView Objekt mithilfe der DataSourceControl.GetView Methode abgerufen und die CanDelete Eigenschaft überprüft wird.

Der keys Parameter stellt die Objekt- oder Zeilenschlüssel der zu löschenden Daten dar. Bei Datenquellen, die relationale Daten darstellen, z. B. das SqlDataSource Steuerelement, ist der keys Parameter eine Sammlung von Primärschlüsseln der Datenbank. In anderen Szenarien ist der keys Parameter eine Sammlung von Name/Wert-Paaren und wird verwendet, um eine Liste von Daten zu filtern. Alle Daten, die mit einem Name/Wert-Paar übereinstimmen, werden gelöscht.

Hinweis

Die DataSourceView Standardimplementierung der Klasse besteht darin, eine NotSupportedException Ausnahme auszuwerfen. Wenn Sie die Klasse erweitern, überschreiben Sie die DataSourceViewExecuteDelete Methode, wenn Ihre Klasse das Löschen aus dem zugrunde liegenden Datenspeicher unterstützt.

Weitere Informationen

• CanDelete