Freigeben über


DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Methode

Definition

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 -> int
Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parameter

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

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.

Gilt für:

Weitere Informationen