MenuDesigner.Initialize Method

Prepares the designer to view, edit, and design the associated control.

Namespace: System.Web.UI.Design.WebControls
Assembly: System.Design (in

public override void Initialize (
	IComponent component
public void Initialize (
	IComponent component
public override function Initialize (
	component : IComponent
Not applicable.



A Menu, which implements the IComponent interface.

Exception typeCondition


component is not a Menu or of a class derived from Menu.

The visual designer calls the Initialize method when it is ready to use the designer to render the Menu control. The Initialize method and its base methods configure properties and set up events that are necessary for the operation of the designer.

The component parameter is the Menu control that is associated with this designer or a copy of that control.

The following code example shows how to override the Initialize method in a class that is inherited from the MenuDesigner class. The overridden method changes the behavior of a control that is derived from the Menu class at design time. The example throws an ArgumentException exception, if the associated control is not a MyMenu object.

public override void Initialize(IComponent component)
    // Ensure that only a MyMenu can be created in this designer.
    if (!(component is MyMenu))
        throw new ArgumentException(
            "The component is not a MyMenu control.");

} // Initialize

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0