LoginDesigner クラス

定義

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

継承

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CompositeControlDesigner

LoginDesigner

例

次のコード例は、 クラスを拡張して、 LoginDesigner デザイン時にコントロールから派生したコントロールの外観を変更する方法を Login 示しています。

この例では、 からコントロールをMyLoginLogin派生させます。 MyLoginはコントロールのLoginコピーです。 この例では、 クラスも から派生MyLoginDesignerし、 コントロールに 属性MyLoginDesignerをMyLogin適用DesignerAttributeLoginDesignerします。

はMyLoginDesigner、デザイン時にPreFilterPropertiesプロパティ グリッドにプロパティをNamingContainer表示するように メソッドをオーバーライドします。 コントロールの プロパティが GetDesignTimeHtml または None 値の場合BorderStyle、コントロールの周囲に青い破線の境界線を描画して、その範囲をより見えるようにするには、 メソッドNotSetをMyLoginオーバーライドします。 メソッドを 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

注釈

コントロールには Login 、ユーザーがホスト Web サイトにログオンできるようにするユーザー インターフェイスが表示されます。

ビジュアル デザイナーで、[ソース] ビューから [デザイン] ビューに切り替えると、コントロールを記述 Login するマークアップ ソース コードが解析され、デザインサーフェイスにデザイン時バージョンのコントロールが作成されます。 [ソース] ビューに戻ると、デザイン時コントロールはマークアップ ソース コードに保持され、Web ページのマークアップに編集されます。 クラスは LoginDesigner 、コントロールのデザイン時のサポートを Login 提供します。

クラス プロパティには LoginDesigner 、次の機能があります。

• プロパティは ActionLists オブジェクトを DesignerActionListCollection 返します。通常、デザイナーの継承ツリーの各レベルの DesignerActionList クラスから派生した オブジェクトが含まれます。

• プロパティは AutoFormats 、[ 書式の自動 設定] ダイアログ ボックスに表示する書式パターンのコレクションを返します。

• プロパティは TemplateGroups 、関連付けられた Login コントロールと最上位 Login のテンプレートのフィールドのテンプレート グループのコレクションを返します。

• プロパティは UsePreviewControl 常に を返 trueします。これは、デザイナーが関連付けられている Login の一時的なコピーを作成してデザイン時マークアップを生成することを示します。

クラス メソッドは LoginDesigner 、次の機能を提供します。

• メソッドは GetDesignTimeHtml 、デザイン時に関連付けられた Login をレンダリングするために使用されるマークアップを返します。

• メソッドは GetEditableDesignerRegionContent 、関連付けられている Loginのテンプレートのシリアル化されたコピーを返します。

• メソッドは GetErrorDesignTimeHtml 、エラーが発生したときに関連付けられた Login をデザイン時にレンダリングするために使用されるマークアップを提供します。

• メソッドは Initialize 、デザイナーが、関連付けられている Loginを表示、編集、およびデザインできるように準備します。

• メソッドは PreFilterProperties 、 からプロパティを削除したり、 にプロパティを追加したり、関連付けられている Loginのプロパティをシャドウしたりするために使用されます。

• メソッドは SetEditableDesignerRegionContent 、コントロール テンプレートのシリアル化されたコピーから関連付けられている Login の領域を設定します。

コンストラクター

プロパティ

メソッド

明示的なインターフェイスの実装

適用対象

こちらもご覧ください

• Login
• CompositeControl
• WebControl
• CompositeControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• ASP.NET コントロール デザイナーの概要
• チュートリアル: Web サーバー コントロールの基本的なコントロール デザイナーを作成する