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コピーです。 この例では、 から クラスをMyLoginStatusDesigner派生させ、 コントロールに のMyLoginStatusDesigner属性をMyLoginStatus適用DesignerAttributeします。LoginStatusDesigner

の 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 サーバー コントロール用の基本的なコントロール デザイナーの作成