DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Methode

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

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.

Gilt für:

Weitere Informationen

• CanUpdate