LoginStatusDesigner クラス

定義

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

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

type LoginStatusDesigner = class
    inherit CompositeControlDesigner

Public Class LoginStatusDesigner
Inherits CompositeControlDesigner

継承

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CompositeControlDesigner

LoginStatusDesigner

例

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

この例では、 からコントロールをMyLoginStatusLoginStatus派生させます。 MyLoginStatusはコントロールのLoginStatusコピーです。 この例では、 から クラスLoginStatusDesignerをMyLoginStatusDesigner派生させ、 コントロールに のMyLoginStatusDesigner属性をMyLoginStatus適用DesignerAttributeします。

の MyLoginStatusDesigner プロパティが GetDesignTimeHtml または None 値の場合BorderStyleは、 メソッドをオーバーライドして、コントロールの周囲に青い破線のMyLoginStatus境界線をNotSet描画して、表示を高めます。

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;
using System.IO;

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

    // Override members of the LoginStatusDesigner.
    public class MyLoginStatusDesigner : LoginStatusDesigner
    {
        // 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. 
            MyLoginStatus myLoginStatusCtl = (MyLoginStatus)ViewControl;
            string markup = null;

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

                // Set the design time properties and catch any exceptions.
                try
                {
                    myLoginStatusCtl.BorderStyle = BorderStyle.Dashed;
                    myLoginStatusCtl.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
    } // MyLoginStatusDesigner
} // 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 MyLoginStatus is a copy of the LoginStatus.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyLoginStatusDesigner))> _
    Public Class MyLoginStatus
        Inherits LoginStatus
    End Class

    ' Override members of the LoginStatusDesigner.
    Public Class MyLoginStatusDesigner
        Inherits LoginStatusDesigner

        ' 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 myLoginStatusCtl As MyLoginStatus = _
                CType(ViewControl, MyLoginStatus)
            Dim markup As String = Nothing

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

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

                ' Set the design time properties and catch any exceptions.
                Try
                    myLoginStatusCtl.BorderStyle = BorderStyle.Dashed
                    myLoginStatusCtl.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

注釈

コントロールは LoginStatus 、ユーザーの認証状態を自動的にチェックし、適切なログインまたはログアウト オプションを表示するボタンをレンダリングします。

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

プロパティは ActionLists オブジェクトを DesignerActionListCollection 返します。通常、デザイナーの継承ツリーの各レベルの DesignerActionList クラスから派生した オブジェクトが含まれます。 プロパティは UsePreviewControl 常に を返 trueします。これは、デザイン時のマークアップを生成するために、デザイナーが関連付けられている LoginStatus の一時的なコピーを作成することを示します。これは、デザイン時にユーザー認証の状態が使用できないためです。

メソッドは GetDesignTimeHtml 、デザイン時に関連付けられた LoginStatus をレンダリングするために使用されるマークアップを返します。 メソッドは Initialize 、デザイナーが、関連付けられている LoginStatusを表示、編集、およびデザインできるように準備します。

コンストラクター

プロパティ

メソッド

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

適用対象

こちらもご覧ください

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