DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

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íče objektu nebo řádku.

values

IDictionary

Dvojice IDictionary název/hodnota, 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

NotSupportedException

Operace ExecuteUpdate(IDictionary, IDictionary, IDictionary) není podporována DataSourceView.

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 uvedeného pro třídu DataSourceView.

// 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, zda ExecuteUpdate je operace podporována ovládacím prvek zdroje dat pomocí DataSourceControl.GetView metody k načtení objektu DataSourceView a kontrole hodnoty CanUpdate vlastnosti.

Parametr keys představuje klíče 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 kolekcí primárních klíčů databáze. V jiných scénářích keys je parametr kolekcí dvojic name/value a slouží k filtrování seznamu dat. Všechna data odpovídající páru název/hodnota se aktualizují s hodnotami nalezenými v parametru values , což je sada dvojic název/hodnota, která představuje 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.

Viz také

• CanUpdate