DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Führt einen Aktualisierungsvorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt.
protected:
virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);protected virtual int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> intProtected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParameter
- keys
- IDictionary
Ein IDictionary von Objekt- oder Zeilenschlüsseln, die durch den Aktualisierungsvorgang aktualisiert werden sollen.
- values
- IDictionary
Ein IDictionary von Name-Wert-Paaren, die Datenelemente und ihre neuen Werte darstellen.
- oldValues
- IDictionary
Ein IDictionary von Name-Wert-Paaren, die Datenelemente und ihre ursprünglichen Werte darstellen.
Gibt zurück
Die Anzahl von Elementen, die im zugrunde liegenden Datenspeicher aktualisiert wurden.
Ausnahmen
Der ExecuteUpdate(IDictionary, IDictionary, IDictionary)-Vorgang wird von der DataSourceView-Klasse nicht unterstützt.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse, die die DataSourceView -Klasse erweitert, die CanUpdate -Eigenschaft und die ExecuteUpdate -Methode überschreiben kann. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataSourceView-Klasse bereitgestellt wird.
// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
get {
return false;
}
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
throw new NotSupportedException();
}
' The CsvDataSourceView does not currently
' permit update operations. You can modify or
' extend this sample to do so.
Public Overrides ReadOnly Property CanUpdate() As Boolean
Get
Return False
End Get
End Property
Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
values As IDictionary, _
oldValues As IDictionary) As Integer
Throw New NotSupportedException()
End Function 'ExecuteUpdate
End Class
Hinweise
Datengebundene Steuerelemente können bestimmen, ob der ExecuteUpdate Vorgang von einem Datenquellensteuerelement unterstützt wird, indem sie die DataSourceControl.GetView -Methode verwenden, um das DataSourceView Objekt abzurufen und den Wert der CanUpdate Eigenschaft zu überprüfen.
Der keys Parameter stellt die Objekt- oder Zeilenschlüssel der zu aktualisierenden Daten dar. Für 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 einem Name-Wert-Paar entsprechen, werden mit den werten aktualisiert, die values im -Parameter gefunden wurden. Dabei handelt es sich um eine Gruppe von Name-Wert-Paaren, die neue Werte für vorhandene Felder oder Spalten darstellen.
Hinweis
Die DataSourceView Standardimplementierung der Klasse besteht darin, eine NotSupportedException Ausnahme auszulösen. Wenn Sie die DataSourceView -Klasse erweitern, überschreiben Sie die ExecuteUpdate -Methode, wenn Ihre Klasse das Aktualisieren von Daten im zugrunde liegenden Datenspeicher unterstützt.
