Object Model
Syntax
| Visual Basic (Declaration) | |
|---|---|
Public Class PlaceHolderManager Inherits ISNet.WebUI.ISNetControl Implements ISNet.ICopyable, ISNet.IObjectState, ISNet.IResetable, ISNet.Serialization.BinarySerialization.IBinarySerialize, ISNet.Serialization.XmlSerialization.ICustomXmlSerializer, ISNet.Serialization.XmlSerialization.IXmlSerialize, ISNet.WebUI.IBaseISNetControl, ISNet.WebUI.IInfo, ISNet.WebUI.ILayoutSettings, IWebMenuControl | |
| Visual Basic (Usage) |  Copy Code |
|---|---|
Dim instance As PlaceHolderManager | |
| C# | |
|---|---|
public class PlaceHolderManager : ISNet.WebUI.ISNetControl, ISNet.ICopyable, ISNet.IObjectState, ISNet.IResetable, ISNet.Serialization.BinarySerialization.IBinarySerialize, ISNet.Serialization.XmlSerialization.ICustomXmlSerializer, ISNet.Serialization.XmlSerialization.IXmlSerialize, ISNet.WebUI.IBaseISNetControl, ISNet.WebUI.IInfo, ISNet.WebUI.ILayoutSettings, IWebMenuControl | |
Remarks
The main objective of the PlaceHolderManager is to enable a certain zone in the WebForm to be marked as "dockable boundaries". This is also called PlaceHolderManager's Container. The container can be either Html Server Control DIV type or Html Server Control TABLE type.
At component design, the PlaceHolderManager is a non-visual server side control which can be instantiated by dropping it from ToolBox. The PlaceHolderManager is also accompanied with a new innovative PlaceHolder Designer to let developers work easily with the PlaceHolderManager and the contained Bars.
One of the important benefits of PlaceHolderManager is its tight integration with IBar implemented controls. The PlaceHolderManager acts as the manager for all bars that it owned. PlaceHolderManager contains all master configurations such as styles and behaviors of the ToolBar and MenuBar.
The tight integration feature significantly improves developer's productivity with the global configurations managed by the PlaceHolderManager, since you don't have to configure the style or behavior of all Bars individually (especially when there are large number of Bars in the WebForm).
Other popular benefit of the integration is the clean tags and reduced HTML output for the Bars server control definition. Each Bar typically would only need to have the Collection definition since other behaviors and the styles are inherited automatically from its PlaceHolderManager.
The following are some recommendations on best practices for using PlaceHolderManager.
Use PlaceHolderManager when:
- The page requires docking functionalities.
- The page contains more than one bar instance.
- The page requires bars which is customizable (through AllowCustomize).
- The page contains multiple type of Bars. For instance, MenuBar and ToolBar.
- The page requires visual styles consistency of all Bars, and style inherittance from DesktopManager.
Do not use PlaceHolderManager when:
- The page contains only one instance of Bar and there are no intentions to add more Bars in the future.
- The page contains bars which doesn't require docking functionalities
Inheritance Hierarchy
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
ISNet.WebUI.ISNetControl
ISNet.WebUI.WebDesktop.PlaceHolderManager
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2