MenuDesigner Clase

Definición

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

Herencia

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

MenuDesigner

Implementaciones

IDataBindingSchemaProvider

Ejemplos

En el ejemplo de código siguiente se muestra cómo extender la MenuDesigner clase para cambiar la apariencia de los controles derivados del Menu control en tiempo de diseño.

En el ejemplo se deriva la MyMenu clase de Menu. La MyMenu clase es una copia de Menu. En el ejemplo también se deriva la MyMenuDesigner clase de la MenuDesigner clase y, a continuación, se aplica un DesignerAttribute atributo para en MyMenuDesigner la MyMenu clase .

The MyMenuDesigner invalida los siguientes MenuDesigner miembros:

• Método GetDesignTimeHtml para dibujar un borde naranja y punteado alrededor del control para que su extensión sea más visible.

• Método GetErrorDesignTimeHtml para generar el marcado de un marcador de posición que incluye el mensaje de error, que se representa en texto rojo y en negrita.

• que GetEmptyDesignTimeHtml se va a generar el marcado de un marcador de posición que contiene un mensaje que indica que no se definen elementos de menú.

• Método Initialize para producir una ArgumentException excepción, si el control asociado no es un 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

Comentarios

La Menu clase proporciona un control de servidor web de menú jerárquico.

En un diseñador visual, al cambiar de la vista Origen a Diseño, el código fuente de marcado que describe el control asociado Menu se analiza y se crea una versión en tiempo de diseño del control en la superficie de diseño. Al volver a la vista Origen, el control en tiempo de diseño se conserva en el marcado y se agrega al marcado existente para la página web. La MenuDesigner clase proporciona compatibilidad en tiempo de diseño para Menu los controles de un diseñador visual.

La ActionLists propiedad devuelve un DesignerActionListCollection objeto , que normalmente contiene un objeto derivado de la DesignerActionList clase para cada nivel del árbol de herencia del diseñador. La AutoFormats propiedad devuelve una colección de esquemas de formato para mostrarse en el cuadro de diálogo Formato automático .

La TemplateGroups propiedad devuelve una colección de grupos de plantillas para las plantillas del control asociado Menu . La UsePreviewControl propiedad siempre devuelve true, lo que indica que el diseñador crea una copia temporal del asociado Menu para generar el marcado en tiempo de diseño.

Los MenuDesigner métodos de clase proporcionan la siguiente funcionalidad:

• El Initialize método prepara el diseñador para ver, editar y diseñar el control asociado Menu . El GetDesignTimeHtml método devuelve el marcado que se usa para representar el asociado Menu en tiempo de diseño.

• El GetEmptyDesignTimeHtml método obtiene el marcado que representa un marcador de posición para el control asociado en tiempo de diseño cuando no hay ningún marcado disponible de otro modo. El GetErrorDesignTimeHtml método proporciona el marcado que representa el control asociado en tiempo de diseño cuando se ha producido un error.

• El DataBind método enlaza el control asociado Menu al origen de datos en tiempo de diseño. El GetSampleDataSource método construye un origen de datos de ejemplo que se puede usar en tiempo de diseño para el control asociado.

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• Menu
• HierarchicalDataBoundControl
• HierarchicalDataBoundControlDesigner
• BaseDataBoundControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Introducción a los diseñadores de controles de ASP.NET
• Tutorial: Crear un control básico Designer para un control de servidor web