InsertItem Method

DetailsView.InsertItem Method

Inserts the current record in the data source.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public virtual void InsertItem (
	bool causesValidation
public void InsertItem (
	boolean causesValidation
public function InsertItem (
	causesValidation : boolean
Not applicable.



true to perform page validation when the method is called; otherwise, false.

Exception typeCondition


This method is called when the DetailsView control is not in insert mode.

- or -

The DataSourceView associated with the DetailsView control is a null reference (Nothing in Visual Basic).

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.


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.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

© 2015 Microsoft