This topic has not yet been rated - Rate this topic

MasterPageControlBuilder Class

Acts as a merging class and container for content pages that are composed only of Content controls and their respective child controls.

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

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)
public class MasterPageControlBuilder : UserControlControlBuilder

The MasterPageControlBuilder type exposes the following members.

  Name Description
Public method MasterPageControlBuilder Initializes a new instance of the MasterPageControlBuilder class.
Top
  Name Description
Public property BindingContainerType Gets the type of the binding container for the control that this builder creates. (Inherited from ControlBuilder.)
Public property ControlType Gets the Type for the control to be created. (Inherited from ControlBuilder.)
Public property 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.)
Public property DeclareType Gets the type that will be used by code generation to declare the control. (Inherited from ControlBuilder.)
Protected property FChildrenAsProperties Determines whether the control has a ParseChildrenAttribute with ChildrenAsProperties set to true. (Inherited from ControlBuilder.)
Protected property FIsNonParserAccessor Determines whether the control implements the IParserAccessor interface. (Inherited from ControlBuilder.)
Public property HasAspCode Gets a value indicating whether the control contains any code blocks. (Inherited from ControlBuilder.)
Public property ID Gets or sets the identifier property for the control to be built. (Inherited from ControlBuilder.)
Protected property InDesigner Returns whether the ControlBuilder is running in the designer. (Inherited from ControlBuilder.)
Protected property InPageTheme Gets a Boolean value indicating whether this ControlBuilder object is used to generate page themes. (Inherited from ControlBuilder.)
Public property Localize Gets a Boolean value indicating whether the control that is created by this ControlBuilder object is localized. (Inherited from ControlBuilder.)
Public property NamingContainerType Infrastructure. Gets the type of the naming container for the control that this builder creates. (Inherited from ControlBuilder.)
Public property PageVirtualPath Gets the virtual path of a page to be built by this ControlBuilder instance. (Inherited from ControlBuilder.)
Protected property Parser Infrastructure. Gets the TemplateParser responsible for parsing the control. (Inherited from ControlBuilder.)
Public property ServiceProvider Gets the service object for this ControlBuilder object. (Inherited from ControlBuilder.)
Public property TagName Gets the tag name for the control to be built. (Inherited from ControlBuilder.)
Public property ThemeResolutionService Gets an IThemeResolutionService object that is used in design time to manage control themes and skins. (Inherited from ControlBuilder.)
Top
  Name Description
Public method 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.)
Public method AppendLiteralString Adds the specified literal content to a control. This method is called by the ASP.NET page framework. (Inherited from ControlBuilder.)
Public method AppendSubBuilder Adds builders to the ControlBuilder object for any child controls that belong to the container control. (Inherited from ControlBuilder.)
Public method BuildObject Infrastructure. Builds an instance of the control identified by the ControlType property. (Inherited from UserControlControlBuilder.)
Public method CloseControl Called by the parser to inform the builder that the parsing of the control's opening and closing tags is complete. (Inherited from ControlBuilder.)
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetChildControlType 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.)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetObjectPersistData Creates the ObjectPersistData object for this ControlBuilder object. (Inherited from ControlBuilder.)
Public method GetResourceKey Infrastructure. Retrieves the resource key for this ControlBuilder object. (Inherited from ControlBuilder.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Public method 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.)
Public method 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.)
Public method Init Initializes the ControlBuilder for use after it is instantiated. This method is called by the ASP.NET page framework. (Inherited from ControlBuilder.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method NeedsTagInnerText Infrastructure. Determines whether the control builder needs to get the control's inner text. (Inherited from UserControlControlBuilder.)
Public method OnAppendToParentBuilder Notifies the ControlBuilder that it is being added to a parent control builder. (Inherited from ControlBuilder.)
Public method ProcessGeneratedCode 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.)
Public method SetResourceKey Infrastructure. Sets the resource key for this ControlBuilder object. (Inherited from ControlBuilder.)
Public method SetServiceProvider Infrastructure. Sets the service object for this ControlBuilder object. (Inherited from ControlBuilder.)
Public method SetTagInnerText Infrastructure. Provides the UserControlControlBuilder object with the inner text of the control tag. (Inherited from UserControlControlBuilder.)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Top

The MasterPageControlBuilder class is used to create a master page that does not inherit from the UserControl class. The classes that you derive from the MasterPageControlBuilder class function as other master pages do, provided that you specify your new class in the Inherits attribute of the .master file that you create in your Web application.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ