BindableTemplateBuilder Class

Definition

Supports page parsing of data-bound controls that automatically bind to an ASP.NET data source control within templated content sections. This class cannot be inherited.

public ref class BindableTemplateBuilder sealed : System::Web::UI::TemplateBuilder, System::Web::UI::IBindableTemplate
public sealed class BindableTemplateBuilder : System.Web.UI.TemplateBuilder, System.Web.UI.IBindableTemplate
type BindableTemplateBuilder = class
    inherit TemplateBuilder
    interface IBindableTemplate
    interface ITemplate
Public NotInheritable Class BindableTemplateBuilder
Inherits TemplateBuilder
Implements IBindableTemplate
Inheritance
BindableTemplateBuilder
Implements

Remarks

The BindableTemplateBuilder class is used in design-time and in no-compile pages to support extracting the values of two-way bound control properties in a data-bound template. The BindableTemplateBuilder object generates the code that implements the IBindableTemplate.ExtractValues method for the template.

The BindableTemplateBuilder is a TemplateBuilder for data-bound controls that include templated content. If the data-bound control is used in design-time or in a no-compile page, the IBindableTemplate interface on the BindableTemplateBuilder is used to parse the two-way data-binding within the templated control. If the data-bound control is compiled, an instance of the CompiledBindableTemplateBuilder class is created and assigned to the value of the IBindableTemplate object.

For more information about ASP.NET data binding, expressions, and syntax, see Binding to Databases and Data-Binding Expressions Overview.

Constructors

BindableTemplateBuilder()

Initializes a new instance of the BindableTemplateBuilder class.

Properties

BindingContainerBuilder

Gets the control builder that corresponds to the binding container for the control that this builder creates.

(Inherited from ControlBuilder)
BindingContainerType

Gets the type of the binding container for the control that this builder creates.

(Inherited from ControlBuilder)
ComplexPropertyEntries

Gets a collection of complex property entries.

(Inherited from ControlBuilder)
ControlType

Gets the Type for the control to be created.

(Inherited from ControlBuilder)
CurrentFilterResolutionService

Gets an IFilterResolutionService object that is used to manage device-filter related services when parsing and persisting controls in the designer.

(Inherited from ControlBuilder)
DeclareType

Gets the type that will be used by code generation to declare the control.

(Inherited from ControlBuilder)
FChildrenAsProperties

Gets a value that determines whether the control has a ParseChildrenAttribute with ChildrenAsProperties set to true.

(Inherited from ControlBuilder)
FIsNonParserAccessor

Gets a value that determines whether the control implements the IParserAccessor interface.

(Inherited from ControlBuilder)
HasAspCode

Gets a value indicating whether the control contains any code blocks.

(Inherited from ControlBuilder)
ID

Gets or sets the identifier property for the control to be built.

(Inherited from ControlBuilder)
InDesigner

Returns whether the ControlBuilder is running in the designer.

(Inherited from ControlBuilder)
InPageTheme

Gets a Boolean value indicating whether this ControlBuilder object is used to generate page themes.

(Inherited from ControlBuilder)
ItemType

Gets the type set on the binding container.

(Inherited from ControlBuilder)
Localize

Gets a Boolean value indicating whether the control that is created by this ControlBuilder object is localized.

(Inherited from ControlBuilder)
NamingContainerType

Gets the type of the naming container for the control that this builder creates.

(Inherited from ControlBuilder)
PageVirtualPath

Gets the virtual path of a page to be built by this ControlBuilder instance.

(Inherited from ControlBuilder)
Parser

Gets the TemplateParser responsible for parsing the control.

(Inherited from ControlBuilder)
ServiceProvider

Gets the service object for this ControlBuilder object.

(Inherited from ControlBuilder)
SubBuilders

Gets a list of child ControlBuilder objects for this ControlBuilder object.

(Inherited from ControlBuilder)
TagName

Gets the tag name for the control to be built.

(Inherited from ControlBuilder)
TemplatePropertyEntries

Gets a collection of template property entries.

(Inherited from ControlBuilder)
Text

Gets or sets the text between the opening and closing tags of the template.

(Inherited from TemplateBuilder)
ThemeResolutionService

Gets an IThemeResolutionService object that is used in design time to manage control themes and skins.

(Inherited from ControlBuilder)

Methods

AllowWhitespaceLiterals()

Determines whether white space literals are permitted in the content between a control's opening and closing tags. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
AppendLiteralString(String)

Adds the specified literal content to a control. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
AppendSubBuilder(ControlBuilder)

Adds builders to the ControlBuilder object for any child controls that belong to the container control.

(Inherited from ControlBuilder)
BuildObject()

Used during design time to build the template and its child controls.

(Inherited from TemplateBuilder)
CloseControl()

Called by the parser to inform the builder that the parsing of the control's opening and closing tags is complete.

(Inherited from TemplateBuilder)
Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractValues(Control)

Retrieves a set of name/value pairs for values that are bound using two-way ASP.NET data-binding syntax within the templated content at design-time and in no-compile pages.

GetChildControlType(String, IDictionary)

Obtains the Type of the control type corresponding to a child tag. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetObjectPersistData()

Creates the ObjectPersistData object for this ControlBuilder object.

(Inherited from ControlBuilder)
GetResourceKey()

Retrieves the resource key for this ControlBuilder object.

(Inherited from ControlBuilder)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
HasBody()

Determines if a control has both an opening and closing tag. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
HtmlDecodeLiterals()

Determines whether the literal string of an HTML control must be HTML decoded. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
Init(TemplateParser, ControlBuilder, Type, String, String, IDictionary)

Initializes the template builder when a Web request is made.

(Inherited from TemplateBuilder)
InstantiateIn(Control)

Defines the Control object that child controls and templates belong to in design time.

(Inherited from TemplateBuilder)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
NeedsTagInnerText()

Determines if the control builder needs to get its inner text.

(Inherited from TemplateBuilder)
OnAppendToParentBuilder(ControlBuilder)

Notifies the BindableTemplateBuilder object that it is being added to a parent control builder.

ProcessGeneratedCode(CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod)

Enables custom control builders to access the generated Code Document Object Model (CodeDom) and insert and modify code during the process of parsing and building controls.

(Inherited from ControlBuilder)
SetResourceKey(String)

Sets the resource key for this ControlBuilder object.

(Inherited from ControlBuilder)
SetServiceProvider(IServiceProvider)

Sets the service object for this ControlBuilder object.

(Inherited from ControlBuilder)
SetTagInnerText(String)

Saves the inner text of the template tag.

(Inherited from TemplateBuilder)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also