Sdílet prostřednictvím


DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metoda

Definice

Provede operaci aktualizace v seznamu dat, která DataSourceView objekt představuje.

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

Parametry

keys
IDictionary

Operace IDictionary aktualizace aktualizuje klíč objektu nebo řádku.

values
IDictionary

Dvojice IDictionary názvů a hodnot, které představují datové prvky a jejich nové hodnoty.

oldValues
IDictionary

Dvojice IDictionary názvů a hodnot, které představují datové prvky a jejich původní hodnoty.

Návraty

Int32

Počet položek, které byly aktualizovány v podkladovém úložišti dat.

Výjimky

Příklady

Následující příklad kódu ukazuje, jak třída, která rozšiřuje DataSourceView třídu může přepsat CanUpdate vlastnost a metodu ExecuteUpdate . Tento příklad kódu je součástí většího příkladu zadaného DataSourceView pro třídu.

// 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

Poznámky

Ovládací prvky vázané na data mohou určit, ExecuteUpdate zda je operace podporována ovládacím prvek zdroje dat pomocí DataSourceControl.GetView metody k načtení DataSourceView objektu a kontrole hodnoty CanUpdate vlastnosti.

Parametr keys představuje klíč objektu nebo řádku dat, která se mají aktualizovat. U zdrojů dat, které představují relační data, jako SqlDataSource je například ovládací prvek, keys je parametr kolekce primárních klíčů databáze. V jiných scénářích keys je parametr kolekcí párů name/value a slouží k filtrování seznamu dat. Všechna data, která odpovídají páru názvů a hodnot, se aktualizují s hodnotami nalezenými v parametru values , což je sada párů name/value, které představují nové hodnoty pro existující pole nebo sloupce.

Poznámka

Výchozí DataSourceView implementace třídy je vyvolání NotSupportedException výjimky. Pokud třídu rozšíříte DataSourceView , přepište metodu ExecuteUpdate , pokud vaše třída podporuje aktualizaci dat v podkladovém úložišti dat.

Platí pro

Viz také