Export (0) Print
Expand All

DataSourceView::ExecuteInsert Method

Performs an insert operation on the list of data that the DataSourceView object represents.

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

protected:
virtual int ExecuteInsert(
	IDictionary^ values
)

Parameters

values
Type: System.Collections::IDictionary

An IDictionary of name/value pairs used during an insert operation.

Return Value

Type: System::Int32
The number of items that were inserted into the underlying data storage.

ExceptionCondition
NotSupportedException

The ExecuteInsert operation is not supported by the DataSourceView.

Data-bound controls can determine whether the ExecuteInsert operation is supported by a data source control by retrieving the DataSourceView object using the GetView method, and checking the CanInsert property.

The values parameter is a set of name/value pairs that represents data columns or fields and corresponding values to insert.

NoteNote

The DataSourceView class's default implementation is to throw a NotSupportedException exception. If you extend the DataSourceView class, override the ExecuteInsert method if your class supports insertion into the underlying data storage.

The following code example demonstrates how a class that extends the DataSourceView class can override the CanInsert property and the ExecuteInsert method. This code example is part of a larger example provided for the DataSourceView class.

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0
Show:
© 2015 Microsoft