LoginDesigner Klass

Definition

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

Arv

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CompositeControlDesigner

LoginDesigner

Exempel

I följande kodexempel visas hur du utökar LoginDesigner klassen för att ändra utseendet på kontroller som härleds från Login kontrollen vid designtillfället.

Exemplet härleder MyLogin kontrollen från Login. MyLogin är en kopia av Login kontrollen. Exemplet härleder MyLoginDesigner även klassen från LoginDesigner och tillämpar ett DesignerAttribute attribut för MyLoginDesignerMyLogin kontrollen.

MyLoginDesigner Åsidosätter PreFilterProperties metoden för att göra NamingContainer egenskapen synlig i rutnätet Egenskaper vid designtillfället. Den åsidosätter GetDesignTimeHtml metoden för att rita en blå, streckad kantlinje runt kontrollen för att göra dess omfattning mer synlig, om BorderStyle kontrollens MyLogin egenskap är NotSet värdet eller None . Den åsidosätter GetErrorDesignTimeHtml metoden för att generera pålägget för en platshållare som innehåller felmeddelandet som återges i röd fet text.

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

Kommentarer

Kontrollen Login visar ett användargränssnitt som gör att en användare kan logga in på värdwebbplatsen.

När du växlar från vyn Källa till Design i en visuell designer parsas källkoden Login som beskriver kontrollen och en designtidsversion av kontrollen skapas på designytan. När du växlar tillbaka till källvyn sparas designtidskontrollen till källkoden för markering och redigeras till markering för webbsidan. Klassen LoginDesigner ger stöd för designtid för Login kontrollen.

Klassegenskaperna LoginDesigner tillhandahåller följande funktioner:

• Egenskapen ActionLists returnerar ett DesignerActionListCollection objekt som vanligtvis innehåller ett objekt som härleds från DesignerActionList klassen för varje nivå i designerns arvsträd.

• Egenskapen AutoFormats returnerar en samling formateringsscheman för visning i dialogrutan Automatiskt format .

• Egenskapen TemplateGroups returnerar en samling mallgrupper för fälten i den associerade Login kontrollen och mallen på den översta nivån Login .

• Egenskapen UsePreviewControl returnerar truealltid , vilket anger att designern skapar en tillfällig kopia av den associerade Login för att generera designtidsmarkeringen.

Klassmetoderna LoginDesigner tillhandahåller följande funktioner:

• Metoden GetDesignTimeHtml returnerar den markering som används för att återge den associerade Login vid designtillfället.

• Metoden GetEditableDesignerRegionContent returnerar en serialiserad kopia av mallen för den associerade Login.

• Metoden GetErrorDesignTimeHtml tillhandahåller den markering som används för att återge den associerade Login vid designtillfället när ett fel har inträffat.

• Metoden Initialize förbereder designern för att visa, redigera och utforma den associerade Login.

• Metoden PreFilterProperties används för att ta bort egenskaper från, lägga till ytterligare egenskaper i eller skuggegenskaper för den associerade Login.

• Metoden SetEditableDesignerRegionContent anger en region för den associerade Login från en serialiserad kopia av en kontrollmall.

Se även

• Login
• CompositeControl
• WebControl
• CompositeControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Introduction till ASP.NET Control Designers
• Genomgång: Skapa en grundläggande kontrolldesigner för en webbserverkontroll