MenuDesigner Sınıf

Tanım

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

Devralma

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

MenuDesigner

Uygulamalar

IDataBindingSchemaProvider

Örnekler

Aşağıdaki kod örneği, tasarım zamanında denetimden türetilen denetimlerin görünümünü değiştirmek için sınıfın Menu nasıl genişletildiğini MenuDesigner gösterir.

Örnek, sınıfından MyMenu sınıfını Menutüretir. MyMenu sınıfı, öğesinin Menubir kopyasıdır. Örnek ayrıca sınıfından MyMenuDesigner sınıfını MenuDesigner türetir ve ardından sınıfı için MyMenuDesignerMyMenu bir DesignerAttribute öznitelik uygular.

The MyMenuDesigner aşağıdaki MenuDesigner üyeleri geçersiz kılar:

• Kapsamını GetDesignTimeHtml daha görünür hale getirmek için denetimin çevresine turuncu, noktalı bir kenarlık çizme yöntemi.

• GetErrorDesignTimeHtml Hata iletisini içeren ve kırmızı, kalın metinle işlenen bir yer tutucu için işaretleme oluşturma yöntemi.

• hiçbir GetEmptyDesignTimeHtml menü öğesinin tanımlanmadığını belirten bir ileti içeren yer tutucu için işaretleme oluşturmak için.

• İlişkili Initialize denetim bir ArgumentExceptionMyMenu nesne değilse özel durum oluşturma yöntemi.

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

Açıklamalar

sınıfı Menu hiyerarşik menü Web sunucusu denetimi sağlar.

Görsel tasarımcıda, Kaynak görünümünden Tasarım görünümüne geçtiğinizde, ilişkili Menu denetimi açıklayan işaretleme kaynak kodu ayrıştırılır ve tasarım yüzeyinde denetimin tasarım zamanı sürümü oluşturulur. Kaynak görünümüne geri döndüğünüzde, tasarım zamanı denetimi işaretlemeye kalıcı olur ve Web sayfası için var olan işaretlemeye eklenir. sınıfı, MenuDesigner görsel tasarımcıdaki denetimler için Menu tasarım zamanı desteği sağlar.

ActionLists özelliği, genellikle tasarımcının devralma ağacındaki her düzey için sınıfından DesignerActionList türetilmiş bir nesne içeren bir nesnesi döndürürDesignerActionListCollection. özelliği, AutoFormatsOtomatik Biçim iletişim kutusunda görüntülenmek üzere bir biçimlendirme düzenleri koleksiyonu döndürür.

özelliği, TemplateGroups ilişkili Menu denetimin şablonları için bir şablon grupları koleksiyonu döndürür. UsePreviewControl özelliği her zaman değerini döndürür trueve tasarımcının tasarım zamanı işaretlemesini oluşturmak için ilişkili Menu öğesinin geçici bir kopyasını oluşturduğunu gösterir.

MenuDesigner Sınıf yöntemleri aşağıdaki işlevleri sağlar:

• Initialize yöntemi, tasarımcıyı ilişkili Menu denetimi görüntülemeye, düzenlemeye ve tasarlamaya hazırlar. yöntemi, GetDesignTimeHtml tasarım zamanında ilişkiliyi Menu işlemek için kullanılan işaretlemeyi döndürür.

• yöntemi, GetEmptyDesignTimeHtml başka bir şekilde kullanılabilir işaretleme olmadığında tasarım zamanında ilişkili denetim için yer tutucu işleyen işaretlemeyi alır. yöntemi, GetErrorDesignTimeHtml bir hata oluştuğunda tasarım zamanında ilişkili denetimi işleyen işaretlemeyi sağlar.

• yöntemi, DataBind ilişkili Menu denetimi tasarım zamanı veri kaynağına bağlar. yöntemi, GetSampleDataSource ilişkili denetim için tasarım zamanında kullanılabilecek bir örnek veri kaynağı oluşturur.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• Menu
• HierarchicalDataBoundControl
• HierarchicalDataBoundControlDesigner
• BaseDataBoundControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• ASP.NET Denetim Tasarımcılarına Giriş
• İzlenecek yol: Web Sunucusu Denetimi için Temel Denetim Tasarımcısı Oluşturma