IBindableTemplate.ExtractValues Method (Control)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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: