IBindableTemplate.ExtractValues(Control) Method

Definition

When implemented by a class, retrieves a set of name/value pairs for values bound using two-way ASP.NET data-binding syntax within the templated content.

public:
 System::Collections::Specialized::IOrderedDictionary ^ ExtractValues(System::Web::UI::Control ^ container);
public System.Collections.Specialized.IOrderedDictionary ExtractValues (System.Web.UI.Control container);
abstract member ExtractValues : System.Web.UI.Control -> System.Collections.Specialized.IOrderedDictionary
Public Function ExtractValues (container As Control) As IOrderedDictionary

Parameters

container
Control

The Control from which to extract name/value pairs, which are passed by the data-bound control to an associated data source control in two-way data-binding scenarios.

Returns

An IOrderedDictionary of name/value pairs. The name represents the name of a control within templated content, and the value is the current value of a property value bound using two-way ASP.NET data-binding syntax.

Notes to Implementers

An ExtractValues(Control) method must conform to the following rules:

  • If more than one binding exists for a given field, the last binding encountered is used.

  • In order to reference a control's identifier in the ExtractValues(Control) method, the control must also have a user-defined ID property at parse time. If no ID exists, this results in a parse error.

  • Two-way ASP.NET data-binding syntax is only valid in an ITemplate or IBindableTemplate property of a data-bound control.

Applies to

See also