ExtractValues Method
Collapse the table of content
Expand the table of content

IBindableTemplate.ExtractValues Method (Control)

 

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.

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

IOrderedDictionary ExtractValues(
	Control container
)

Parameters

container
Type: System.Web.UI.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.

Return Value

Type: System.Collections.Specialized.IOrderedDictionary

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 Inheritors:

An ExtractValues 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 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.

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft