Export (0) Print
Expand All

UserControlControlBuilder Class

Supports the page parser in building a user control and any child user controls that it contains.

For a list of all members of this type, see UserControlControlBuilder Members.

System.Object
   System.Web.UI.ControlBuilder
      System.Web.UI.UserControlControlBuilder

[Visual Basic]
Public Class UserControlControlBuilder
   Inherits ControlBuilder
[C#]
public class UserControlControlBuilder : ControlBuilder
[C++]
public __gc class UserControlControlBuilder : public ControlBuilder
[JScript]
public class UserControlControlBuilder extends ControlBuilder

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Remarks

By default, every user control on a page is associated with a default UserControlControlBuilder class. This class adds a child control to the Controls property for every nested user control that it encounters within the custom control tags. Additionally, it creates literal controls for the text located between nested control tags. You can create custom user control builder funtionality by extending this class.

Example

[Visual Basic] The following example creates a custom UserControlControlBuilder class that overrides the AllowWhitespaceLiterals method that this class inherits from the ControlBuilder class. When applied to a UserControl class, white spaces found in the user control are ignored.

[Visual Basic] 
' This is a Custom builder for user controls.
' It does not allow white space to be returned
' as instances of the LiteralControl class.
Public Class CustomUCBuilder
   Inherits UserControlControlBuilder
    Public Sub New()
    End Sub
  
  ' UserControlControlBuilder inherits this from
  ' ControlBuilder, but uses the base functionality
  ' of the method. You can override it to 
  ' create the custom behavior you want.  
  Public Overrides Function AllowWhitespaceLiterals() As Boolean
     Return False
  End Function
End Class

[C#, C++, JScript] No example is available for C#, C++, or JScript. To view a Visual Basic example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Web.UI

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

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

See Also

UserControlControlBuilder Members | System.Web.UI Namespace | UserControl | ControlBuilder

Show:
© 2014 Microsoft