DataSourceView.Update Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Performs an asynchronous update operation on the list of data that the DataSourceView object represents.
public:
virtual void Update(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues, System::Web::UI::DataSourceViewOperationCallback ^ callback);
public virtual void Update (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues, System.Web.UI.DataSourceViewOperationCallback callback);
abstract member Update : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary * System.Web.UI.DataSourceViewOperationCallback -> unit
override this.Update : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary * System.Web.UI.DataSourceViewOperationCallback -> unit
Public Overridable Sub Update (keys As IDictionary, values As IDictionary, oldValues As IDictionary, callback As DataSourceViewOperationCallback)
Parameters
- keys
- IDictionary
An IDictionary of object or row keys to be updated by the update operation.
- values
- IDictionary
An IDictionary of name/value pairs that represent data elements and their new values.
- oldValues
- IDictionary
An IDictionary of name/value pairs that represent data elements and their original values.
- callback
- DataSourceViewOperationCallback
A DataSourceViewOperationCallback delegate that is used to notify a data-bound control when the asynchronous operation is complete.
Exceptions
The DataSourceViewOperationCallback supplied is null
.
Remarks
The Update method is the asynchronous data modification interface for all data source view objects. The Update method calls the ExecuteUpdate method using any keys
, values
, and oldValues
parameter values supplied. The callback
parameter is a delegate that a data-bound control passes to the data source view, which is used to notify the data-bound control when the ExecuteUpdate operation has completed. The method uses the parameters of the DataSourceViewOperationCallback delegate to return the number of affected records and any Exception exception that is thrown by the ExecuteUpdate call.