DetailsView.UpdateItem(Boolean) 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.
Updates the current record in the data source.
public:
virtual void UpdateItem(bool causesValidation);
public virtual void UpdateItem (bool causesValidation);
abstract member UpdateItem : bool -> unit
override this.UpdateItem : bool -> unit
Public Overridable Sub UpdateItem (causesValidation As Boolean)
Parameters
- causesValidation
- Boolean
true
to perform page validation when the method is called; otherwise, false
.
Exceptions
This method is called when the DetailsView control is not in edit mode.
-or-
The DataSourceView associated with the DetailsView control is null
.
Remarks
When the DetailsView control is in edit mode, use the UpdateItem method to programmatically update the current record in the data source. This method is commonly used when you need to update the current record from outside of the DetailsView control, such as from a different control on the page.
Note
The DetailsView control must be in edit mode when this method is called; otherwise, an HttpException exception is thrown.
To specify whether page validation is performed before the update operation, use the causesValidation
parameter. Calling this method also raises the ItemUpdated and ItemUpdating events.