DetailsView.InsertItem(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.
Inserts the current record in the data source.
public:
virtual void InsertItem(bool causesValidation);public virtual void InsertItem (bool causesValidation);abstract member InsertItem : bool -> unit
override this.InsertItem : bool -> unitPublic Overridable Sub InsertItem (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 insert mode.
-or-
The DataSourceView associated with the DetailsView control is null.
Remarks
When the DetailsView control is in insert mode, use the InsertItem method to programmatically insert the current record in the data source. This method is commonly used when you need to insert 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 insert mode when this method is called; otherwise, an HttpException exception is thrown.
To specify whether page validation is performed before the insert operation, use the causesValidation parameter. Calling this method also raises the ItemInserted and ItemInserting events.
