LabelDesigner クラス

Label Web サーバー コントロールに対してデザイン時の動作を拡張します。

この型のすべてのメンバの一覧については、LabelDesigner メンバ を参照してください。

System.Object
   System.ComponentModel.Design.ComponentDesigner
      System.Web.UI.Design.HtmlControlDesigner
         System.Web.UI.Design.ControlDesigner
            System.Web.UI.Design.TextControlDesigner
               System.Web.UI.Design.WebControls.LabelDesigner

Public Class LabelDesigner
   Inherits TextControlDesigner
[C#]
public class LabelDesigner : TextControlDesigner
[C++]
public __gc class LabelDesigner : public TextControlDesigner
[JScript]
public class LabelDesigner extends TextControlDesigner

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

使用例

[Visual Basic] LabelDesigner クラスから派生したカスタム デザイナのコード例を次に示します。このカスタム デザイナは、 TextControlDesigner.GetDesignTimeHtml メソッドをオーバーライドします。これにより、このデザイナが表示する SampleLabel クラスのインスタンスで BorderStyle プロパティに値が設定されているかどうかがチェックされます。設定されていない場合は、 BorderStyle 列挙体の Dashed 列挙値を設定します。なお、デザイン画面でのコントロールの既定の表示方法をカスタマイズする場合にも、これと同様の手順を利用できます。

 
Imports System
Imports System.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Diagnostics
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports Examples.AspNet

Namespace Examples.AspNet.Design

    Public Class SampleLabelDesigner
        Inherits LabelDesigner
        
        ' Override the GetDesignTimeHtml method.
        Public Overrides Function GetDesignTimeHtml() As String

            Dim sampleLabel As SampleLabel = CType(Component, SampleLabel)
            Dim designTimeHtml As String = Nothing
    
            ' Check the control's BorderStyle property
            ' to conditionally render design-time HTML.
            If (sampleLabel.BorderStyle = BorderStyle.NotSet) Then

                ' Create variables to hold current property settings.
                Dim oldBorderStyle As BorderStyle = sampleLabel.BorderStyle
                    
               ' Set properties and the design-time HTML.
                Try
                    sampleLabel.BorderStyle = BorderStyle.Dashed
                    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
                    sampleLabel.BorderStyle = oldBorderStyle
                End Try
          
            Else
                designTimeHtml = MyBase.GetDesignTimeHtml()
            End If
      
            Return designTimeHTML
        End Function
    End Class
End Namespace

[Visual Basic] Label クラスから派生した SampleLabel カスタム コントロールのコード例を次に示します。この例では、 SampleLabelDesigner クラスを使用してコントロールをデザイン画面に表示します。

 
' Create a SampleLabel class that derives from
' the Label class and is associated with the 
' CustomLabelDesigner class by incuding a  
' reference to the designer in the Designer
' metadata attribute.
Namespace Examples.AspNet

    <DesignerAttribute( _
        GetType(Examples.AspNet.Design.SampleLabelDesigner))> _
    Public Class SampleLabel
        Inherits Label
        ' Include code here for a custom 
        ' class that inherits from Button.        
    End Class
End Namespace

[C#, C++, JScript] C#、C++、および JScript のサンプルはありません。Visual Basic のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Web.UI.Design.WebControls

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Design (System.Design.dll 内)

参照

LabelDesigner メンバ | System.Web.UI.Design.WebControls 名前空間 | Label