Export (0) Print
Expand All

SqlDataSourceView.UpdateCommand Property

Gets or sets the SQL string that the SqlDataSourceView object uses to update data in the underlying database.

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

member UpdateCommand : string with get, set

Property Value

Type: System.String
A SQL string that the SqlDataSourceView uses to update data.

Because different database products use different varieties of SQL, the syntax of the SQL string depends on the current ADO.NET provider being used, which is identified by the ProviderName property. If the SQL string is a parameterized query or command, the placeholder of the parameter also depends on the ADO.NET provider being used. For example, if the provider is the System.Data.SqlClient, which is the default provider for the SqlDataSource class, the placeholder of the parameter is '@parameterName'. However, if the provider is set to the System.Data.Odbc or System.Data.OleDb, the placeholder of the parameter is '?'. For more information on parameterized SQL queries and commands, see Using Parameters with the SqlDataSource Control.

The UpdateCommand property can be an SQL string or the name of a stored procedure, if the data source supports stored procedures.

The value of the UpdateCommand property is stored in view state.

This section contains two code examples. The first code example demonstrates how to set the UpdateCommand property of the SqlDataSource control and update data in a Microsoft SQL Server database using the GridView control. The second code example demonstrates how to update data in an ODBC database using the GridView control.

The following code example demonstrates how to set the UpdateCommand property of the SqlDataSource control and update data in a SQL Server database using the GridView control. The GridView control automatically populates the UpdateParameters collection, inferring the parameters from the BoundField objects, and calls the Update method when the Update link on the editable GridView control is selected. This example also includes some post-processing—after a record is updated, an e-mail message notification is sent.

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

The following code example, which is functionally identical to the preceding code example, demonstrates how to update data in an ODBC database using the GridView control. The ProviderName property is set to the ADO.NET provider for ODBC, the System.Data.Odbc, and the ConnectionString property is set to the name of an ODBC data source name (DSN).

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