Extracts the value of the data control field from the current table cell and adds the value to the specified IDictionary collection.
Assembly: System.Web (in System.Web.dll)
abstract ExtractValuesFromCell : dictionary:IOrderedDictionary * cell:DataControlFieldCell * rowState:DataControlRowState * includeReadOnly:bool -> unit override ExtractValuesFromCell : dictionary:IOrderedDictionary * cell:DataControlFieldCell * rowState:DataControlRowState * includeReadOnly:bool -> unit
- Type: System.Web.UI.WebControls.DataControlFieldCell
- Type: System.Boolean
true to indicate that the values of read-only fields are included in the dictionary collection; otherwise, false.
The method is implemented by types derived from DataControlField to associate the current field with a value, if applicable. The field/value pair is stored in the dictionary collection that is passed to the method. The method is called by the ExtractRowValues method of data controls such as DetailsView and GridView.
Call this method when you are writing a custom data-bound control that uses DataControlFieldCell objects to assemble a set of cells and their associated values. Implement this method when you are writing a class derived from DataControlField that displays user data or data-bound data. Not all derived types implement the method, because not all fields display user data. For example, the ButtonField control displays a button and has no user data.
The following code example demonstrates how to implement the method for a control that derives from the DataControlField class. The RadioButtonField class renders a data-bound radio button for every row in a GridView control. When the method is called, the method attempts to determine whether the current value of the RadioButton object contained in the cell is selected or cleared, and adds the value to the IDictionary collection. This code example is part of a larger example provided for the DataControlField class.