This documentation is archived and is not being maintained.

SqlDataSourceView::Insert Method (IDictionary)

Performs an insert operation using the InsertCommand SQL string, any parameters that are specified in the InsertParameters collection, and the values that are in the specified values collection.

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

public:
int Insert(
	IDictionary^ values
)

Parameters

values
Type: System.Collections::IDictionary
An IDictionary of parameters for the InsertCommand property to use to perform the insert database operation. If there are no parameters associated with the query or if the InsertCommand is not a parameterized SQL query, pass nullptr.

Return Value

Type: System::Int32
A value that represents the number of rows inserted into the underlying database.

ExceptionCondition
InvalidOperationException

The SqlDataSource cannot establish a connection with the underlying data source.

NotSupportedException

The CanInsert property is false.

The Insert method calls the ExecuteInsert method, passing the values parameter.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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