ButtonDesigner クラス

.NET Framework クラス ライブラリ リファレンス

ButtonDesigner クラス

Button Web サーバー コントロールを、ビジュアルなデザイナで、デザイン時に使用できるようにするために使用します。

名前空間: System.Web.UI.Design.WebControls
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Class ButtonDesigner
    Inherits ControlDesigner

Visual Basic (使用法)

Dim instance As ButtonDesigner

C#

public class ButtonDesigner : ControlDesigner

C++

public ref class ButtonDesigner : public
 ControlDesigner

J#

public class ButtonDesigner extends ControlDesigner

JScript

public class ButtonDesigner extends
 ControlDesigner

解説

ビジュアルなデザイナでソース ビューからデザイン ビューに切り替えると、Button コントロールを記述するマークアップのソース コードが解析され、コントロールのデザイン時バージョンがデザイン サーフェイスに作成されます。元のソース ビューに切り替えると、デザイン時コントロールがマークアップのソース コードに永続化され、Web ページのマークアップに反映されます。

使用例

このセクションには、2 つのコード例が用意されています。最初のコード例は、ButtonDesigner クラスを拡張する方法を示しています。2 番目のコード例は、Button クラスを拡張して、最初のコード例で作成したクラスに関連付ける方法を示しています。

ButtonDesigner クラスを拡張して、GetDesignTimeHtml メソッドをオーバーライドするカスタム デザイナ クラスを作成する方法を次のコード例に示します。BorderStyle プロパティがまだ設定されていない (つまり、NotSet フィールド値がない) 場合、GetDesignTimeHtml メソッドを呼び出すと、このプロパティが幅 3 ピクセルの青い点線の境界線に設定され、その境界線がデザイン サーフェイスに表示されます。BorderStyle プロパティに値が既に設定されている場合は、既存の境界線プロパティの値が表示されます。

通常、GetDesignTimeHtml は、その基本メソッドである ControlDesigner.GetDesignTimeHtml を呼び出します。この基本メソッドは、関連付けられたコントロールの Control.RenderControl メソッドを呼び出して、マークアップを生成します。

Visual Basic

' Create a class that derives from ButtonDesigner
' and displays the custom SampleButton control
' on the design surface.
Imports System
Imports System.Web.UI.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls

Namespace Examples.AspNet 

    
    Public Class SampleButtonDesigner
        Inherits ButtonDesigner

        ' Override the GetDesignTimeHtml method.
        Public Overrides Function
 GetDesignTimeHtml() As String

            Dim sampleButton As SampleButton
 = CType(Component, SampleButton)
            Dim designTimeHtml As String
 = Nothing

            ' Check the control's BorderStyle property
            ' to conditionally render design-time HTML.
            If (sampleButton.BorderStyle = BorderStyle.NotSet)
 Then

                ' Create variables to hold current property settings.
                Dim oldBorderStyle As BorderStyle
 = sampleButton.BorderStyle
                Dim oldBorderWidth As Unit
 = sampleButton.BorderWidth
                Dim oldBorderColor As Color
 = sampleButton.BorderColor

                ' Set properties and the design-time HTML.
                Try
                    sampleButton.BorderStyle = BorderStyle.Dashed
                    sampleButton.BorderWidth = Unit.Pixel(3)
                    sampleButton.BorderColor = Color.Blue
                    designTimeHtml = MyBase.GetDesignTimeHtml()

                    ' If an exception occurs, call the GetErrorDesignTimeHtml
                    ' method.
                Catch ex As Exception
                    designTimeHtml = GetErrorDesignTimeHtml(ex)

                    ' Return properties to their original settings.
                Finally
                    sampleButton.BorderStyle = oldBorderStyle
                    sampleButton.BorderWidth = oldBorderWidth
                    sampleButton.BorderColor = oldBorderColor
                End Try

            Else
                designTimeHtml = MyBase.GetDesignTimeHtml()
            End If

            Return designTimeHtml

        End Function

    End Class
End Namespace

Button クラスを拡張し、上記の例で作成した SampleButtonDesigner クラスに DesignerAttribute オブジェクトを使用して関連付ける単純なクラスの使用方法を次のコード例に示します。

Visual Basic

<DesignerAttribute( _
    GetType(Examples.AspNet.SampleButtonDesigner))> _
Public Class SampleButton
    Inherits Button
    ' Include code here for a custom 
    ' class that inherits from Button.        
End Class

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.ComponentModel.Design.ComponentDesigner
     System.Web.UI.Design.HtmlControlDesigner
       System.Web.UI.Design.ControlDesigner
        System.Web.UI.Design.WebControls.ButtonDesigner

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ButtonDesigner メンバ
System.Web.UI.Design.WebControls 名前空間
Button
ControlDesigner クラス
その他の技術情報
ASP.NET コントロール デザイナの概要
チュートリアル : Web サーバー コントロール用の基本的なコントロール デザイナの作成