Edit

Share via


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);

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

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

See also