Supports the page parser in building a control and the child controls it contains.
Assembly: System.Web (in System.Web.dll)
Gets the type of the binding container for the control that this builder creates.
Gets a collection of complex property entries.
Gets the Type for the control to be created.
Gets an IFilterResolutionService object that is used to manage device-filter related services when parsing and persisting controls in the designer.
Gets the type that will be used by code generation to declare the control.
Gets a value that determines whether the control implements the IParserAccessor interface.
Gets a value indicating whether the control contains any code blocks.
Gets or sets the identifier property for the control to be built.
Returns whether theis running in the designer.
Gets a Boolean value indicating whether thisobject is used to generate page themes.
Gets the type set on the binding container.
Gets a Boolean value indicating whether the control that is created by thisobject is localized.
This API supports the product infrastructure and is not intended to be used directly from your code. Gets the type of the naming container for the control that this builder creates.
Gets the virtual path of a page to be built by thisinstance.
This API supports the product infrastructure and is not intended to be used directly from your code. Gets the TemplateParser responsible for parsing the control.
Gets the service object for thisobject.
Gets a list of childobjects for this object.
Gets the tag name for the control to be built.
Gets a collection of template property entries.
Gets an IThemeResolutionService object that is used in design time to manage control themes and skins.
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.
Adds the specified literal content to a control. This method is called by the ASP.NET page framework.
Adds builders to theobject for any child controls that belong to the container control.
Builds a design-time instance of the control that is referred to by thisobject.
Called by the parser to inform the builder that the parsing of the control's opening and closing tags is complete.
|CreateBuilderFromType(TemplateParser, ControlBuilder, Type, String, String, IDictionary, Int32, String)|
Creates aobject from the specified tag name and object type, as well as other parameters defining the builder.
Determines whether the specified object is equal to the current object.(Inherited from Object.)
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
Obtains the Type of the control type corresponding to a child tag. This method is called by the ASP.NET page framework.
Serves as the default hash function. (Inherited from Object.)
Creates the ObjectPersistData object for this object.
This API supports the product infrastructure and is not intended to be used directly from your code. Retrieves the resource key for thisobject.
Determines if a control has both an opening and closing tag. This method is called by the ASP.NET page framework.
Determines whether the literal string of an HTML control must be HTML decoded. This method is called by the ASP.NET page framework.
|Init(TemplateParser, ControlBuilder, Type, String, String, IDictionary)|
Initializes thefor use after it is instantiated. This method is called by the ASP.NET page framework.
Determines if the control builder needs to get its inner text. If so, the SetTagInnerText method must be called. This method is called by the ASP.NET page framework.
Notifies thethat 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.
This API supports the product infrastructure and is not intended to be used directly from your code. Sets the resource key for thisobject.
This API supports the product infrastructure and is not intended to be used directly from your code. Sets the service object for thisobject.
Provides thewith the inner text of the control tag.
Returns a string that represents the current object.(Inherited from Object.)
By default, every control on a page is associated with a default ControlBuilderAttribute attribute to your control builder class as follows:class. During parsing, the ASP.NET page framework builds a tree of objects corresponding to the tree of controls for the page. The tree is then used to generate page code to create the control tree. In addition to child controls, the defines the behavior of how the content within control tags is parsed. You can override this default behavior by defining your own custom control builder class. This is done by applying a
Legacy Code Example
The following code example creates a Table control whose attributes and content are defined at the time the table is built. The following is the command line to use to build the executable.
vbc /r:System.dll /r:System.Web.dll /r:System.Drawing.dll /t:library /out:myWebAppPath/Bin/vb_mycontrolbuilder.dll myControlBuilder.vb
csc /t:library /out:myWebAppPath/Bin/cs_mycontrolbuilder.dll myControlBuilder.cs
The following code example uses the previous custom control. In particular, it builds a table whose attributes and content are defined at run time. Notice that the values shown in the directive reflect the previous command line.Code snippet is not found. Confirm that the code snippet name 'SystemWebUI_ControlBuilder_2' is correct.
Available since 1.1
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.