ObjectDataSourceView.Update Method (IDictionary, IDictionary, IDictionary)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Performs an update operation by calling the method that is identified by the UpdateMethod property and using any parameters that are supplied in the keys, values, or oldValues collections.

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

public int Update(
	IDictionary keys,
	IDictionary values,
	IDictionary oldValues
)

Parameters

keys
Type: System.Collections.IDictionary

A IDictionary of the key values used to identify the item to update. These parameters are used with the method specified by the UpdateMethod property to perform the update operation. If there are no parameters associated with the method, pass null.

values
Type: System.Collections.IDictionary

A IDictionary of new values to apply to the data source. These parameters are used with the method specified by the UpdateMethod property to perform the update database operation. If there are no parameters associated with the method, pass null.

oldValues
Type: System.Collections.IDictionary

A IDictionary that contains the additional non-key values used to match the item in the data source. Row values are passed to the delete method, only if the ConflictDetection property is set to the CompareAllValues field.

Return Value

Type: System.Int32

The number of rows updated; otherwise, -1, if the number is not known.

The default return value is -1, which means that an unknown number of rows were updated. To return a different value, set the AffectedRows property of the ObjectDataSourceStatusEventArgs object of the Updated event. The number of affected rows is typically returned by the Update method for the business object, and that value is available from the ReturnValue property of the ObjectDataSourceStatusEventArgs parameter of the Updated event.

The Update method calls the ExecuteUpdate method, passing the keys, values, and oldValues parameters.

.NET Framework
Available since 2.0
Return to top
Show: