System.Web 2.0.0.0 System.ComponentModel.CancelEventArgs

The control raises the event when an Update button (a button with its CommandName property set to "Update") within the control is clicked, but before the control updates the record. This allows you to provide an event handler that performs a custom routine, such as HTML-encoding the values of a record before updating it in the data source, whenever this event occurs.

A object is passed to the event handler, which allows you to determine the value of an optional command argument sent to the control and to indicate whether the update operation should be canceled. To determine the value of the command argument, use the property. To cancel the update operation, set the property to true. You can also read or modify the new values entered by the user by using the and properties. The property contains the key fields, while the property contains the non-key fields. If you need to access the original non-key field values, use the property.

For more information about handling events, see Consuming Events.

For a list of initial property values for an instance of the class, see the constructor.

Provides data for the event.

- Constructor
  To be added.

  Use this constructor to initialize a new instance of the class.

  The following table shows the initial property value for an instance of the class.

  Property

  Initial Value

  The value of the parameter.

  This constructor is used primarily by control developers when raising events.

  Initializes a new instance of the class.

  2.0.0.0
- Property
  System.Object To be added.

  Use the property to determine the value of the command argument passed to the control.

  Gets the command argument for the update operation passed to the control.

  2.0.0.0
- Property
  System.Collections.Specialized.IOrderedDictionary To be added.

  Use the property to access the values of the key fields for the record to update. For example, you can use these values to keep a log of updated records.

  This property contains only the key fields. To access the updated and original non-key fields, use the and properties, respectively.

  The property returns an object that implements the interface. The object contains objects that represent the fields of the record to update.

  As a shortcut, you can also use the indexer of the object to access the field values directly.

  Gets a dictionary that contains the key field name/value pairs for the record to update.

  2.0.0.0
- Property
  System.Collections.Specialized.IOrderedDictionary To be added.

  Use the property to access the new field values for the record to update. For example, you can use these values to keep a log of updated records.

  This property does not contain the key fields. To access the key fields, use the property. You can also access the original field values by using the property.

  The property returns an object that implements the interface. The object contains objects that represent the fields of the record to update.

  As a shortcut, you can also use the indexer of the object to access the field values directly.

  Gets a dictionary that contains the new field name/value pairs for the record to update.

  2.0.0.0
- Property
  System.Collections.Specialized.IOrderedDictionary To be added.

  Use the property to access the original field values for the updated record. For example, you can use these values to keep a log of updated records.

  This property does not contain the key fields. To access the key fields, use the property. You can also access the new field values entered by the user by using the property.

  The property returns an object that implements the interface. The object contains objects that represent the fields of the record to update.

  As a shortcut, you can also use the indexer of the object to access the field values directly.

  Gets a dictionary that contains the original field name/value pairs for the record to update.

  2.0.0.0