LoginDesigner Sınıf

Tanım

public ref class LoginDesigner : System::Web::UI::Design::WebControls::CompositeControlDesigner

public class LoginDesigner : System.Web.UI.Design.WebControls.CompositeControlDesigner

type LoginDesigner = class
    inherit CompositeControlDesigner

Public Class LoginDesigner
Inherits CompositeControlDesigner

Devralma

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CompositeControlDesigner

LoginDesigner

Ö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 Login nasıl genişletildiğini LoginDesigner gösterir.

Örnek, denetiminden türetir MyLoginLogin. MyLogin denetimin Login bir kopyasıdır. Örnek ayrıca sınıfından LoginDesigner sınıfını MyLoginDesigner türetir ve denetiminde MyLogin için MyLoginDesigner bir DesignerAttribute öznitelik uygular.

özelliği MyLoginDesigner tasarım zamanında Özellikler kılavuzunda görünür hale getirmek NamingContainer için yöntemini geçersiz kılarPreFilterProperties. Denetimin GetDesignTimeHtml özelliği veya None değeriyseBorderStyle, kapsamını daha görünür hale getirmek için denetimin MyLoginNotSet çevresine mavi, kesikli bir kenarlık çizmek için yöntemini geçersiz kılar. Kırmızı, kalın metin olarak işlenen hata iletisini içeren bir yer tutucu için işaretleme oluşturmak için yöntemini geçersiz kılar GetErrorDesignTimeHtml .

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

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

    // Override members of the LoginDesigner.
    [ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
    public class MyLoginDesigner : LoginDesigner
    {
        // Generate the design-time markup for the control when an error occurs.
        protected override string GetErrorDesignTimeHtml(Exception e) 
        {
            // Write the error message text in red, bold.
            string errorRendering =
                "<span style=\"font-weight:bold; color:Red; \">" +
                e.Message + "</span>";

            return CreatePlaceHolderDesignTimeHtml(errorRendering);
        } // GetErrorDesignTimeHtml

        // Shadow the 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()
        {
            // Make the control more visible in the designer.  If the border 
            // style is None or NotSet, change the border to a blue dashed line. 
            MyLogin myLoginCtl = (MyLogin)ViewControl;
            string markup = null;

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

                // Set the design time properties and catch any exceptions.
                try
                {
                    myLoginCtl.BorderStyle = BorderStyle.Dashed;
                    myLoginCtl.BorderColor = Color.Blue;

                    // Call the base method to generate the markup.
                    markup = base.GetDesignTimeHtml();
                }
                catch (Exception ex)
                {
                    markup = GetErrorDesignTimeHtml(ex);
                }
                finally
                {
                    // It is not necessary to restore the border properties 
                    // to their original values because the ViewControl 
                    // was used to reference the associated control and the 
                    // UsePreviewControl was not overridden.  

                    // myLoginCtl.BorderStyle = oldBorderStyle;
                    // myLoginCtl.BorderColor = oldBorderColor;
                }
            }
            else
            {
                // Call the base method to generate the markup.
                markup = base.GetDesignTimeHtml();
            }

            return markup;
        } // GetDesignTimeHtml
    } // MyLoginDesigner
} // Examples.CS.WebControls.Design

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

Namespace Examples.VB.WebControls.Design

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

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

        ' 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

        ' Shadow the 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() As String

            ' Make the control more visible in the designer.  If the border 
            ' style is None or NotSet, change the border to a blue dashed line. 
            Dim myLoginCtl As MyLogin = CType(ViewControl, MyLogin)
            Dim markup As String = Nothing

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

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

                ' Set the design time properties and catch any exceptions.
                Try
                    myLoginCtl.BorderStyle = BorderStyle.Dashed
                    myLoginCtl.BorderColor = Color.Blue

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

                Catch ex As Exception
                    markup = GetErrorDesignTimeHtml(ex)

                Finally
                    ' It is not necessary to restore the border properties 
                    ' to their original values because the ViewControl 
                    ' was used to reference the associated control and the 
                    ' UsePreviewControl was not overridden.  

                    ' myLoginCtl.BorderStyle = oldBorderStyle
                    ' myLoginCtl.BorderColor = oldBorderColor
                End Try

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

            Return markup

        End Function ' GetDesignTimeHtml
    End Class
End Namespace ' Examples.VB.WebControls.Design

Açıklamalar

Denetim, Login kullanıcının konak Web sitesinde oturum açmasına izin veren bir kullanıcı arabirimi görüntü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 Login 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ı, LoginDesigner denetim için Login tasarım zamanı desteği sağlar.

LoginDesigner Sınıf özellikleri aşağıdaki işlevleri 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 Login denetimin alanları ve en üst düzey Login şablon 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 Login öğesinin geçici bir kopyasını oluşturduğunu gösterir.

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

• yöntemi, GetDesignTimeHtml tasarım zamanında ilişkiliyi Login işlemek için kullanılan işaretlemeyi döndürür.

• yöntemi, GetEditableDesignerRegionContent ilişkili Loginiçin şablonun serileştirilmiş bir kopyasını döndürür.

• yöntemi, GetErrorDesignTimeHtml bir hata oluştuğunda tasarım zamanında ilişkiliyi Login işlemek için kullanılan işaretlemeyi sağlar.

• Initialize yöntemi, tasarımcıyı ilişkili Loginöğesini görüntülemeye, düzenlemeye ve tasarlamaya hazırlar.

• PreFilterProperties yöntemi, 'den özellikleri kaldırmak, öğesine ek özellikler eklemek veya ilişkili Loginöğesinin gölge özelliklerini eklemek için kullanılır.

• yöntemi, SetEditableDesignerRegionContent denetim şablonunun serileştirilmiş bir kopyasından ilişkili Login bir bölgesini ayarlar.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• Login
• CompositeControl
• WebControl
• CompositeControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• ASP.NET Denetim Tasarımcılarına Giriş
• İzlenecek yol: Web Sunucusu Denetimi için Temel Denetim Tasarım Aracı Oluşturma