LoginDesigner Klas

Definitie

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

Overname

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CompositeControlDesigner

LoginDesigner

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de LoginDesigner klasse kunt uitbreiden om het uiterlijk van besturingselementen te wijzigen die zijn afgeleid van het besturingselement tijdens het Login ontwerp.

In het voorbeeld wordt het MyLogin besturingselement afgeleid van de Login. Het MyLogin is een kopie van het Login besturingselement. In het voorbeeld wordt ook de MyLoginDesigner klasse afgeleid van de LoginDesigner klasse en wordt een DesignerAttribute kenmerk toegepast voor het MyLoginDesignerMyLogin besturingselement.

De MyLoginDesigner methode wordt overschreven PreFilterProperties om de NamingContainer eigenschap zichtbaar te maken in het eigenschappenraster tijdens het ontwerp. De methode wordt overschreven GetDesignTimeHtml om een blauwe, stippelrand rond het besturingselement te tekenen om de omvang ervan beter zichtbaar te maken als de BorderStyle eigenschap van het MyLogin besturingselement de NotSet of None waarde is. De methode wordt overschreven GetErrorDesignTimeHtml om de markeringen te genereren voor een tijdelijke aanduiding die het foutbericht bevat dat wordt weergegeven in rood, vetgedrukt.

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

Opmerkingen

Het Login besturingselement geeft een gebruikersinterface weer waarmee een gebruiker zich kan aanmelden bij de hostwebsite.

Wanneer u in een visuele ontwerper overschakelt van de bronweergave naar de ontwerpweergave, wordt de broncode voor markeringen die het Login besturingselement beschrijft geparseerd en wordt er een ontwerptijdversie van het besturingselement gemaakt op het ontwerpoppervlak. Wanneer u terugschakelt naar de bronweergave, wordt het ontwerptijdbesturingselement behouden in de broncode van de markering en bewerkt in de markeringen voor de webpagina. De LoginDesigner klasse biedt ontwerptijdondersteuning voor het Login besturingselement.

De LoginDesigner klasse-eigenschappen bieden de volgende functionaliteit:

• De ActionLists eigenschap retourneert een DesignerActionListCollection object, dat meestal een object bevat dat is afgeleid van de DesignerActionList klasse voor elk niveau in de overnamestructuur van de ontwerper.

• De AutoFormats eigenschap retourneert een verzameling opmaakschema's voor weergave in het dialoogvenster Automatische opmaak .

• De TemplateGroups eigenschap retourneert een verzameling sjabloongroepen voor de velden van het gekoppelde Login besturingselement en de sjabloon op het hoogste niveau Login .

• De UsePreviewControl eigenschap retourneert truealtijd, waarmee wordt aangegeven dat de ontwerper een tijdelijke kopie maakt van de gekoppelde Login markeringen voor het genereren van de ontwerptijd.

De LoginDesigner klassemethoden bieden de volgende functionaliteit:

• De GetDesignTimeHtml methode retourneert de markeringen die worden gebruikt om de bijbehorende Login markeringen weer te geven tijdens het ontwerp.

• De GetEditableDesignerRegionContent methode retourneert een geserialiseerde kopie van de sjabloon voor de bijbehorende Login.

• De GetErrorDesignTimeHtml methode biedt de markeringen die worden gebruikt om de bijbehorende Login tijdens het ontwerptijd weer te geven wanneer er een fout is opgetreden.

• De Initialize methode bereidt de ontwerpfunctie voor om de bijbehorende Loginitems weer te geven, te bewerken en te ontwerpen.

• De PreFilterProperties methode wordt gebruikt om eigenschappen te verwijderen uit, extra eigenschappen toe te voegen aan of schaduweigenschappen van de bijbehorende Logineigenschappen.

• Met SetEditableDesignerRegionContent de methode wordt een regio van de gekoppelde Login regio ingesteld op basis van een geserialiseerde kopie van een besturingselementsjabloon.

Zie ook

• Login
• CompositeControl
• WebControl
• CompositeControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Toegang tot ASP.NET Besturingsontwerpers
• Overzicht: Een eenvoudige ontwerpfunctie voor besturingselementen maken voor een webserverbesturing