LoginViewDesigner Sınıf

Tanım

public ref class LoginViewDesigner : System::Web::UI::Design::ControlDesigner

public class LoginViewDesigner : System.Web.UI.Design.ControlDesigner

type LoginViewDesigner = class
    inherit ControlDesigner

Public Class LoginViewDesigner
Inherits ControlDesigner

Devralma

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

LoginViewDesigner

Örnekler

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

Örnek, denetiminden türetir MyLoginViewLoginView. MyLoginView denetimin LoginView bir kopyasıdır. Örnek ayrıca sınıfından sınıfını MyLoginViewDesignerLoginViewDesigner türetir ve denetiminde MyLoginView için MyLoginViewDesigner bir DesignerAttribute öznitelik uygular.

Denetim MyLoginViewDesigner aşağıdaki LoginViewDesigner üyeleri geçersiz kılar:

• PreFilterProperties Özelliği tasarım zamanında Özellikler kılavuzunda görünür hale getirme NamingContainer yöntemi.

• Kapsamını GetDesignTimeHtml daha görünür hale getirmek için denetimin çevresine turuncu 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.

• Denetim GetEmptyDesignTimeHtml için tanımlanan rol gruplarının adlarını içeren bir yer tutucu için işaretleme oluşturma yöntemi.

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

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

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

    // Override members of the LoginViewDesigner.
    [ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
    public class MyLoginViewDesigner : LoginViewDesigner
    {
        // 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()
        {
            // Generate a design-time placeholder containing the names of all
            // the role groups.
            MyLoginView myLoginViewCtl = (MyLoginView)ViewControl;
            RoleGroupCollection roleGroups = myLoginViewCtl.RoleGroups;
            string roleNames = null;

            // If there are any role groups, form a string of their names.
            if (roleGroups.Count > 0)
            {
                roleNames = "Role Groups: <br />   " + 
                    roleGroups[0].ToString();

                for( int rgX = 1; rgX < roleGroups.Count; rgX++ )
                    roleNames += 
                        "<br />   " + roleGroups[rgX].ToString();
            }
            return CreatePlaceHolderDesignTimeHtml( roleNames);
        } // GetEmptyDesignTimeHtml

        // Shadow control properties with design-time properties.
        protected override void PreFilterProperties(IDictionary properties)
        {
            // Call the base method first.
            base.PreFilterProperties(properties);

            // Make the NamingContainer visible in the Properties grid.
            PropertyDescriptor selectProp = 
                (PropertyDescriptor)properties["NamingContainer"];
            properties["NamingContainer"] =
                TypeDescriptor.CreateProperty(selectProp.ComponentType, 
                    selectProp, BrowsableAttribute.Yes);
        } // PreFilterProperties

        // Generate the design-time markup.
        public override string GetDesignTimeHtml(DesignerRegionCollection regions)
        {
            // Make the control more visible in the designer.   
            // Enclose the markup in a table with an orange border. 
            const string openTableMarkup =
                "<table><tr><td style=\"border:4 solid #FF7F00;\">";
            const string closeTableMarkup = "</td></tr></table>";

            // Call the base method to generate the markup.
            string markup = base.GetDesignTimeHtml(regions);

            return openTableMarkup + markup + closeTableMarkup;
        } // GetDesignTimeHtml

        public override void Initialize(IComponent component)
        {
            // Ensure that only a MyLoginView can be created in this designer.
            if (!(component is MyLoginView))
                throw new ArgumentException();

            // Call the base method to generate the markup.
            base.Initialize(component);
        } // Initialize
    } // MyLoginViewDesigner
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Imports System.IO

Namespace Examples.VB.WebControls.Design

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

    ' Override members of the LoginViewDesigner.
    <ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _
    Public Class MyLoginViewDesigner
        Inherits LoginViewDesigner

        ' 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

            ' Generate a design-time placeholder containing the names of all
            ' the role groups.
            Dim myLoginViewCtl As MyLoginView = CType(ViewControl, MyLoginView)
            Dim roleGroups As RoleGroupCollection = myLoginViewCtl.RoleGroups
            Dim RoleNames As String = Nothing
            Dim rgX As Integer

            ' If there are any role groups, form a string of their names.
            If roleGroups.Count > 0 Then

                roleNames = "Role Groups: <br />   " & _
                    roleGroups(0).ToString()

                For rgX = 1 To roleGroups.Count - 1
                    roleNames &= "<br />   " & _
                        roleGroups(rgX).ToString()
                Next rgX
            End If

            Return CreatePlaceHolderDesignTimeHtml(roleNames)

        End Function ' GetEmptyDesignTimeHtml

        ' Shadow control properties with design-time properties.
        Protected Overrides Sub PreFilterProperties( _
            ByVal properties As IDictionary)

            ' Call the base method first.
            MyBase.PreFilterProperties(properties)

            ' Make the NamingContainer visible in the Properties grid.
            Dim selectProp As PropertyDescriptor = _
                CType(properties("NamingContainer"), PropertyDescriptor)
            properties("NamingContainer") = _
                TypeDescriptor.CreateProperty(selectProp.ComponentType, _
                    selectProp, BrowsableAttribute.Yes)

        End Sub

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

            ' Make the control more visible in the designer.  
            ' Enclose the markup in a table with an orange border. 
            Dim openTableMarkup As String = _
                "<table><tr><td style=""border:4 solid #FF7F00;"">"
            Dim closeTableMarkup As String = "</td></tr></table>"

            ' Call the base method to generate the markup.
            Dim markup As String = MyBase.GetDesignTimeHtml(regions)

            Return openTableMarkup & markup & closeTableMarkup

        End Function ' GetDesignTimeHtml

        ' Generate the design time markup.
        Public Overrides Sub Initialize(ByVal component As IComponent)

            ' Ensure that only a MyLoginView can be created in this designer. 
            If Not TypeOf component Is MyLoginView Then
                Throw New ArgumentException()
            End If

            ' Call the base method to generate the markup.
            MyBase.Initialize(component)

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

Açıklamalar

Denetim LoginView , bir kullanıcının konak Web sitesinde oturum açıp açmadığına ve oturum açmış kullanıcı hesabını içeren rollere göre belirlenen şablonlarından birini işler.

Görsel tasarımcıda, Kaynak görünümünden Tasarım görünümüne geçtiğinizde, denetimi açıklayan LoginView 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şaretleme kaynak kodunda kalıcı hale getirilir ve Web sayfasının işaretlemesinde düzenlenir. sınıfı, LoginViewDesigner denetim için LoginView tasarım zamanı desteği sağlar.

ActionLists özelliği, genellikle tasarımcının DesignerActionList devralma ağacındaki her düzey için sınıfından türetilmiş bir nesne içeren bir nesnesi döndürürDesignerActionListCollection. özelliği, TemplateGroups ilişkili LoginView denetimin şablonları için bir şablon grupları koleksiyonu döndürür. UsePreviewControl özelliği her zaman döndürür trueve tasarımcının tasarım zamanı işaretlemesini oluşturmak için ilişkili LoginView denetimin geçici bir kopyasını oluşturduğunu gösterir.

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

• Yöntemler, GetDesignTimeHtml tasarım zamanında ilişkili LoginView denetimi işlemek için kullanılan işaretlemeyi döndürür. yöntemi, GetEmptyDesignTimeHtml geçerli şablon tanımlanmadığında tasarım zamanında ilişkili denetim için bir yer tutucu oluşturan 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, GetEditableDesignerRegionContent ilişkili LoginView denetim için geçerli şablonun serileştirilmiş bir kopyasını döndürür. yöntemi, SetEditableDesignerRegionContent bir denetim şablonunun serileştirilmiş kopyasından ilişkili denetimin bölgesini ayarlar.

• Initialize yöntemi, tasarımcıyı ilişkili LoginView denetimi görüntülemeye, düzenlemeye ve tasarlamaya hazırlar. yöntemi OnComponentChanged , ilişkili denetimde bir değişiklik olduğunda çağrılır. PreFilterProperties yöntemi, ilgili denetimin özelliklerinden özellikleri kaldırmak, ek özellikler eklemek veya gölge özelliklerini eklemek için kullanılır.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• LoginView
• Control
• 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