Export (0) Print
Expand All

FormView.InsertItem Method

Inserts the current record in the data source.

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

abstract InsertItem : 
        causesValidation:bool -> unit  
override InsertItem : 
        causesValidation:bool -> unit

Parameters

causesValidation
Type: System.Boolean

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

ExceptionCondition
HttpException

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

-or-

The DataSourceView object associated with the FormView control is null.

When the FormView 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 FormView control, such as from a different control on the page.

NoteNote

The FormView control must be in insert mode when this method is called; otherwise, an HttpException 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.

The following example demonstrates how to use the InsertItem method to programmatically insert the current record in a FormView control in the data source.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft