MenuDesigner Klass

Definition

public ref class MenuDesigner : System::Web::UI::Design::WebControls::HierarchicalDataBoundControlDesigner, System::Web::UI::Design::IDataBindingSchemaProvider

public class MenuDesigner : System.Web.UI.Design.WebControls.HierarchicalDataBoundControlDesigner, System.Web.UI.Design.IDataBindingSchemaProvider

type MenuDesigner = class
    inherit HierarchicalDataBoundControlDesigner
    interface IDataBindingSchemaProvider

Public Class MenuDesigner
Inherits HierarchicalDataBoundControlDesigner
Implements IDataBindingSchemaProvider

Arv

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

MenuDesigner

Implementeringar

IDataBindingSchemaProvider

Exempel

I följande kodexempel visas hur du utökar MenuDesigner klassen för att ändra utseendet på kontroller som härleds från Menu kontrollen vid designtillfället.

Exemplet härleder MyMenu klassen från Menu. Klassen MyMenu är en kopia av Menu. Exemplet härleder MyMenuDesigner även klassen från MenuDesigner klassen och tillämpar sedan ett DesignerAttribute attribut för MyMenuDesigner klassen på .MyMenu

The MyMenuDesigner åsidosätter följande MenuDesigner medlemmar:

• Metoden GetDesignTimeHtml för att rita en orange, prickad kantlinje runt kontrollen för att göra dess omfattning mer synlig.

• Metoden GetErrorDesignTimeHtml för att generera markering för en platshållare som innehåller felmeddelandet, som återges i röd, fet text.

• För GetEmptyDesignTimeHtml att generera markering för en platshållare som innehåller ett meddelande som anger att inga menyalternativ har definierats.

• Metoden Initialize för att utlösa ett ArgumentException undantag om den associerade kontrollen inte är ett MyMenu objekt.

using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;
using System.Drawing;

namespace Examples.CS.WebControls.Design
{
    // The MyMenu is a copy of the Menu.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyMenuDesigner))]
    public class MyMenu : Menu
    {
    } // MyMenu

    // Override members of the MenuDesigner.
    public class MyMenuDesigner : MenuDesigner
    {
        // Generate the design-time markup for the control when an error occurs.
        protected override string GetErrorDesignTimeHtml(Exception ex) 
        {
            // Write the error message text in red, bold.
            string errorRendering =
                "<span style=\"font-weight:bold; color:Red; \">" +
                ex.Message + "</span>";

            return CreatePlaceHolderDesignTimeHtml(errorRendering);
        } // GetErrorDesignTimeHtml

        // Generate the design-time markup for the control 
        // when the template is empty.
        protected override string GetEmptyDesignTimeHtml()
        {
            string noElements = "Contains no menu items.";

            return CreatePlaceHolderDesignTimeHtml(noElements);
        } // GetEmptyDesignTimeHtml

        // Generate the design-time markup.
        public override string GetDesignTimeHtml()
        {
            // Make the control more visible in the designer.  If the border 
            // style is None or NotSet, change the border to an orange dotted line. 
            MyMenu myMenuCtl = (MyMenu)ViewControl;
            string markup = null;

            // Check if the border style should be changed.
            if (myMenuCtl.BorderStyle == BorderStyle.NotSet ||
                myMenuCtl.BorderStyle == BorderStyle.None)
            {
                BorderStyle oldBorderStyle = myMenuCtl.BorderStyle;
                Color oldBorderColor = myMenuCtl.BorderColor;

                // Set the design-time properties and catch any exceptions.
                try
                {
                    myMenuCtl.BorderStyle = BorderStyle.Dotted;
                    myMenuCtl.BorderColor = Color.FromArgb(0xFF7F00);

                    // Call the base method to generate the markup.
                    markup = base.GetDesignTimeHtml();
                }
                catch (Exception ex)
                {
                    markup = GetErrorDesignTimeHtml(ex);
                }
                finally
                {
                    // Restore the properties to their original settings.
                    myMenuCtl.BorderStyle = oldBorderStyle;
                    myMenuCtl.BorderColor = oldBorderColor;
                }
            }
            else
            {
                // Call the base method to generate the markup.
                markup = base.GetDesignTimeHtml();
            }

            return markup;
        } // GetDesignTimeHtml

        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.");
            
            base.Initialize(component);
        } // Initialize
    } // MyMenuDesigner
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions
Imports System.Drawing

Namespace Examples.VB.WebControls.Design

    ' The MyMenu is a copy of the Menu.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyMenuDesigner))> _
    Public Class MyMenu
        Inherits Menu
    End Class

    ' Override members of the MenuDesigner.
    Public Class MyMenuDesigner
        Inherits MenuDesigner

        ' Generate the design-time markup for the control when an error occurs.
        Protected Overrides Function GetErrorDesignTimeHtml( _
            ByVal ex As Exception) As String

            ' Write the error message text in red, bold.
            Dim errorRendering As String = _
                "<span style=""font-weight:bold; color:Red; "">" & _
                ex.Message & "</span>"

            Return CreatePlaceHolderDesignTimeHtml(errorRendering)

        End Function ' GetErrorDesignTimeHtml

        ' Generate the design-time markup for the control 
        ' when the template is empty.
        Protected Overrides Function GetEmptyDesignTimeHtml() As String

            Dim noElements As String = "Contains no menu items."

            Return CreatePlaceHolderDesignTimeHtml(noElements)

        End Function ' GetEmptyDesignTimeHtml

        ' Generate the design-time markup.
        Public Overrides Function GetDesignTimeHtml() As String

            ' Make the control more visible in the designer.  If the border 
            ' style is None or NotSet, change the border to an orange dotted line. 
            Dim myMenuCtl As MyMenu = CType(ViewControl, MyMenu)
            Dim markup As String = Nothing

            ' Check if the border style should be changed.
            If (myMenuCtl.BorderStyle = BorderStyle.NotSet Or _
                myMenuCtl.BorderStyle = BorderStyle.None) Then

                Dim oldBorderStyle As BorderStyle = myMenuCtl.BorderStyle
                Dim oldBorderColor As Color = myMenuCtl.BorderColor

                ' Set the design-time properties and catch any exceptions.
                Try
                    myMenuCtl.BorderStyle = BorderStyle.Dotted
                    myMenuCtl.BorderColor = Color.FromArgb(&HFF7F00)

                    ' Call the base method to generate the markup.
                    markup = MyBase.GetDesignTimeHtml()

                Catch ex As Exception
                    markup = GetErrorDesignTimeHtml(ex)

                Finally
                    ' Restore the properties to their original settings.
                    myMenuCtl.BorderStyle = oldBorderStyle
                    myMenuCtl.BorderColor = oldBorderColor
                End Try

            Else
                ' Call the base method to generate the markup.
                markup = MyBase.GetDesignTimeHtml()
            End If

            Return markup

        End Function ' GetDesignTimeHtml

        Public Overrides Sub Initialize(ByVal component As IComponent)

            ' Ensure that only a MyMenu can be created in this designer. 
            If Not TypeOf component Is MyMenu Then
                Throw New ArgumentException( _
                    "The component is not a MyMenu control.")
            End If

            MyBase.Initialize(component)

        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

Kommentarer

Klassen Menu innehåller en hierarkisk meny för webbserverkontroll.

När du växlar från vyn Källa till Design i en visuell designer parsas källkoden som beskriver den associerade Menu kontrollen och en designtidsversion av kontrollen skapas på designytan. När du växlar tillbaka till källvyn sparas designtidskontrollen till markering och läggs till i den befintliga markeringen för webbsidan. Klassen MenuDesigner ger designtidsstöd för Menu kontroller i en visuell designer.

Egenskapen ActionLists returnerar ett DesignerActionListCollection objekt som vanligtvis innehåller ett objekt som härleds från DesignerActionList klassen för varje nivå i designerns arvsträd. Egenskapen AutoFormats returnerar en samling formateringsscheman för visning i dialogrutan Automatiskt format .

Egenskapen TemplateGroups returnerar en samling mallgrupper för mallarna för den associerade Menu kontrollen. Egenskapen UsePreviewControl returnerar truealltid , vilket anger att designern skapar en tillfällig kopia av den associerade Menu för att generera designtidsmarkeringen.

Klassmetoderna MenuDesigner tillhandahåller följande funktioner:

• Metoden Initialize förbereder designern för att visa, redigera och utforma den associerade Menu kontrollen. Metoden GetDesignTimeHtml returnerar den markering som används för att återge den associerade Menu vid designtillfället.

• Metoden GetEmptyDesignTimeHtml hämtar den markering som återger en platshållare för den associerade kontrollen vid designtillfället när ingen markering är tillgänglig på annat sätt. Metoden GetErrorDesignTimeHtml tillhandahåller den markering som återger den associerade kontrollen vid designtillfället när ett fel har inträffat.

• Metoden DataBind binder den associerade Menu kontrollen till datakällan designtid. Metoden GetSampleDataSource konstruerar en exempeldatakälla som kan användas vid designtillfället för den associerade kontrollen.

Se även

• Menu
• HierarchicalDataBoundControl
• HierarchicalDataBoundControlDesigner
• BaseDataBoundControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Introduction till ASP.NET Control Designers
• Genomgång: Skapa en grundläggande kontrolldesigner för en webbserverkontroll