BindableTemplateBuilder Class

Reference

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

ControlBuilder

TemplateBuilder
BindableTemplateBuilder

Implements: IBindableTemplate ITemplate

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

Dela via