MenuDesigner Classe

Definição

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

Herança

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

MenuDesigner

Implementações

IDataBindingSchemaProvider

Exemplos

O exemplo de código seguinte mostra como estender a MenuDesigner classe para alterar a aparência dos controlos derivados do Menu controlo no momento do projeto.

O exemplo deriva a MyMenu classe a partir do Menu. A MyMenu classe é uma cópia do Menu. O exemplo também deriva a MyMenuDesigner classe a partir da MenuDesigner classe e depois aplica um DesignerAttribute atributo para o MyMenuDesigner na MyMenu classe.

The MyMenuDesigner Sobrepõe-se aos seguintes MenuDesigner membros:

• O GetDesignTimeHtml método para desenhar uma borda laranja pontilhada à volta do controlo para tornar a sua extensão mais visível.

• O GetErrorDesignTimeHtml método para gerar a marcação para um marcador que inclui a mensagem de erro, que é apresentada em texto vermelho e negrito.

• O GetEmptyDesignTimeHtml para gerar a marcação para um marcador de posição que contém uma mensagem indicando que nenhum item do menu está definido.

• O Initialize método para lançar uma ArgumentException exceção, se o controlo associado não for um MyMenu objeto.

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

Observações

A Menu classe fornece um menu hierárquico de controlo de servidor Web.

Num designer visual, ao mudar da vista Source para a vista Design, o código-fonte de marcação que descreve o controlo associado Menu é analisado e uma versão em tempo de design do controlo é criada na superfície de design. Quando volta para a vista Fonte, o controlo de tempo de design é mantido para a marcação e adicionado à marcação existente para a página Web. A MenuDesigner classe fornece suporte em tempo de design para Menu controlos num designer visual.

A ActionLists propriedade devolve um DesignerActionListCollection objeto, que normalmente contém um objeto derivado da DesignerActionList classe para cada nível na árvore de herança do designer. A AutoFormats propriedade devolve uma coleção de esquemas de formatação para mostrar na caixa de diálogo Formatar Automaticamente .

A TemplateGroups propriedade devolve uma coleção de grupos de modelos para os modelos do controlo associado Menu . A UsePreviewControl propriedade devolve truesempre , indicando que o designer cria uma cópia temporária do associado Menu para gerar a marcação em tempo de design.

Os MenuDesigner métodos de classe fornecem a seguinte funcionalidade:

• O Initialize método prepara o designer para visualizar, editar e desenhar o controlo associado Menu . O GetDesignTimeHtml método devolve a marcação que é usada para renderizar a associada Menu no momento do design.

• O GetEmptyDesignTimeHtml método recebe a marcação que gera um marcador de posição para o controlo associado no momento do design, quando não existe outra marcação disponível. O GetErrorDesignTimeHtml método fornece a marcação que renderiza o controlo associado no momento do projeto quando ocorre um erro.

• O DataBind método associa o Menu controlo associado à fonte de dados em tempo de design. O GetSampleDataSource método constrói uma fonte de dados de amostra que pode ser usada no momento do design para o controlo associado.

Ver também

• Menu
• HierarchicalDataBoundControl
• HierarchicalDataBoundControlDesigner
• BaseDataBoundControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Introdução aos Designers de Controlo ASP.NET
• Guia: Criar um Designer Básico de Controlo para um Controlo de Servidor Web