ListControlDesigner クラス

定義

public ref class ListControlDesigner : System::Web::UI::Design::ControlDesigner, System::Web::UI::Design::IDataSourceProvider

public ref class ListControlDesigner : System::Web::UI::Design::WebControls::DataBoundControlDesigner

public class ListControlDesigner : System.Web.UI.Design.ControlDesigner, System.Web.UI.Design.IDataSourceProvider

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class ListControlDesigner : System.Web.UI.Design.WebControls.DataBoundControlDesigner

type ListControlDesigner = class
    inherit ControlDesigner
    interface IDataSourceProvider

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type ListControlDesigner = class
    inherit DataBoundControlDesigner

Public Class ListControlDesigner
Inherits ControlDesigner
Implements IDataSourceProvider

Public Class ListControlDesigner
Inherits DataBoundControlDesigner

継承

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

ListControlDesigner

継承

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

ListControlDesigner

派生

System.Web.UI.Design.WebControls.BulletedListDesigner

属性

SupportsPreviewControlAttribute

実装

IDataSourceProvider

例

このセクションでは、2 つのコード例を示します。 1 つ目は、カスタム コントロール デザイナーを派生させる方法を示しています。 2 つ目は、派生コントロールをデザイナーに関連付ける方法を示しています。

次のコード例は、 クラスから継承する という名前 SimpleRadioButtonListDesigner のクラスを作成する方法を ListControlDesigner 示しています。 クラスはSimpleRadioButtonListDesigner、GetDesignTimeHtmlInitializeおよび の各メソッドをOnDataSourceChangedオーバーライドします。 クラスは SimpleRadioButtonListDesigner 、デザインサーフェイスに SimpleRadioButtonList コントロールを表示します。

using System;
using System.ComponentModel;
using System.Drawing;
using System.Diagnostics;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;

namespace Examples.CS.WebControls.Design
{
    // Create the SimpleRadioButtonListDesigner, which provides
    // design-time support for a custom list class.
    public class SimpleRadioButtonListDesigner : ListControlDesigner
    {
        SimpleRadioButtonList simpleRadioButtonList;
        bool changedDataSource;

        // Create the markup to display the control on the design surface. 
        public override string GetDesignTimeHtml()
        {
            string designTimeMarkup = null;

            // Create variables to access the control
            // item collection and back color.
            ListItemCollection items = simpleRadioButtonList.Items;
            Color oldBackColor = simpleRadioButtonList.BackColor;

            // Check the property values and render the markup
            // on the design surface accordingly.
            try
            {
                if (oldBackColor == Color.Empty)
                    simpleRadioButtonList.BackColor = Color.Gainsboro;

                if (changedDataSource)
                    items.Add("Updated to a new data source: " + 
                        DataSource + ".");

                // Call the base method to generate the markup.
                designTimeMarkup = base.GetDesignTimeHtml();
            }
            catch (Exception ex)
            {
                // Catch any exceptions that occur.
                designTimeMarkup = GetErrorDesignTimeHtml(ex);
            }
            finally
            {
                // Set the properties back to their original state.
                simpleRadioButtonList.BackColor = oldBackColor;
                items.Clear();
            }

            return designTimeMarkup;
        } // GetDesignTimeHtml

        public override void Initialize(IComponent component)
        {
            // Ensure that only a SimpleRadioButtonList can be 
            // created in this designer.
            Debug.Assert( 
                component is SimpleRadioButtonList, 
                "An invalid SimpleRadioButtonList control was initialized.");

            simpleRadioButtonList = (SimpleRadioButtonList)component;
            base.Initialize(component);
        } // Initialize

        // If the data source changes, set a boolean variable.
        public override void OnDataSourceChanged()
        {
            changedDataSource = true;
        } // OnDataSourceChanged
    } // SimpleRadioButtonListDesigner
} // Examples.CS.WebControls.Design

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

Namespace Examples.VB.WebControls.Design

    ' Create the SimpleRadioButtonListDesigner, which provides
    ' design-time support for a custom list class.  
    Public Class SimpleRadioButtonListDesigner
        Inherits ListControlDesigner

        Private simpleRadioButtonList As SimpleRadioButtonList
        Private changedDataSource As Boolean

        ' Create the markup to display the control on the design surface.
        Public Overrides Function GetDesignTimeHtml() As String

            Dim designTimeHtml As String = String.Empty

            ' Create variables to access the control's
            ' item collection and back color. 
            Dim items As ListItemCollection = simpleRadioButtonList.Items
            Dim oldBackColor As Color = simpleRadioButtonList.BackColor

            ' Check the property values and render the markup
            ' on the design surface accordingly.
            Try
                If (Color.op_Equality(oldBackColor, Color.Empty)) Then
                    simpleRadioButtonList.BackColor = Color.Gainsboro
                End If

                If (changedDataSource) Then
                    items.Add( _
                        "Updated to a new data source: " & DataSource & ".")
                End If

                designTimeHtml = MyBase.GetDesignTimeHtml()

            Catch ex As Exception
                ' Catch any exceptions that occur.
                MyBase.GetErrorDesignTimeHtml(ex)

            Finally
                ' Set the properties back to their original state.
                simpleRadioButtonList.BackColor = oldBackColor
                items.Clear()
            End Try

            Return designTimeHtml
        End Function ' GetDesignTimeHtml

        Public Overrides Sub Initialize(ByVal component As IComponent)

            ' Ensure that only a SimpleRadioButtonList can be created 
            ' in this designer.
            Debug.Assert( _
                TypeOf component Is SimpleRadioButtonList, _
                "An invalid SimpleRadioButtonList control was initialized.")

            simpleRadioButtonList = CType(component, SimpleRadioButtonList)
            MyBase.Initialize(component)
        End Sub

        ' If the data source changes, set a Boolean variable.
        Public Overrides Sub OnDataSourceChanged()
            changedDataSource = True
        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

次のコード例では、コントロールからコントロールをRadioButtonList派生SimpleRadioButtonListさせ、 クラスを使用してコントロールをDesignerAttributeデザイナーの クラスに関連付けるSimpleRadioButtonList方法をSimpleRadioButtonListDesigner示します。

using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The SimpleRadioButtonList is a copy of the RadioButtonList.
    // It uses the SimpleRadioButtonListDesigner for design-time support.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.
       SimpleRadioButtonListDesigner))]
    [DataBindingHandler(typeof(Examples.CS.WebControls.Design.
        SimpleRadioButtonListDataBindingHandler))]
    public class SimpleRadioButtonList : RadioButtonList
    {
    } // SimpleRadioButtonList
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The SimpleRadioButtonList is a copy of the RadioButtonList.
    ' It uses the SimpleRadioButtonListDesigner for design-time support.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <DesignerAttribute(GetType(Examples.VB.WebControls.Design. _
        SimpleRadioButtonListDesigner))> _
    <DataBindingHandler(GetType(Examples.VB.WebControls.Design. _
        SimpleRadioButtonListDataBindingHandler))> _
    Public Class SimpleRadioButtonList
        Inherits RadioButtonList
    End Class
End Namespace ' Examples.VB.WebControls.Design

注釈

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

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

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

• プロパティと DataValueField プロパティはDataTextField、 クラスから派生したコントロールの対応するプロパティへのアクセスをListControl提供します。 と DataValueField はDataTextField、リスト アイテムのテキストと値の内容を提供するデータ ソースのフィールドをそれぞれ示します。

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

• メソッドは DataBind 、 から ListControl 派生した関連付けられたコントロールをデザイン時データ ソースにバインドします。

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

• メソッドは GetSelectedDataSource 、関連付けられたコントロール コンテナーからデザイン時 DataSource コンポーネントを返します。

• メソッドは GetResolvedSelectedDataSource コントロール コンテナーから を DataSource 返し、コントロールのデザイン時 DataMember プロパティに解決されます。

• メソッドは Initialize 、 から派生した関連付けられたコントロールを表示および設計するようにデザイナーを準備します ListControl。

• OnDataSourceChanged関連付けられたコントロールの がDataSource変更されると、 メソッドが呼び出されます。

• メソッドは PreFilterProperties 、 から追加のプロパティを削除したり、 から派生した関連付けられたコントロールのプロパティを追加したり、シャドウ プロパティを削除したりするために使用されます ListControl。

コンストラクター

プロパティ

メソッド

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

適用対象

こちらもご覧ください

• ListControl
• DataBoundControl
• DataBoundControlDesigner
• BaseDataBoundControl
• BaseDataBoundControlDesigner
• WebControl
• ControlDesigner
• ASP.NET コントロール デザイナーの概要
• チュートリアル: Web サーバー コントロールの基本的なコントロール デザイナーを作成する