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

예제

이 섹션에서는 두 코드 예제를 제공합니다. 첫 번째는 사용자 지정 컨트롤 디자이너를 파생하는 방법을 보여 줍니다. 두 번째는 파생된 컨트롤을 디자이너와 연결하는 방법을 보여 줍니다.

다음 코드 예제에서는 클래스에서 ListControlDesigner 상속 하는 라는 SimpleRadioButtonListDesigner 클래스를 만드는 방법을 보여 줍니다. 클래스는 SimpleRadioButtonListDesigner , Initialize및 OnDataSourceChanged 메서드를 재정의GetDesignTimeHtml합니다. 클래스는 SimpleRadioButtonListDesignerSimpleRadioButtonList 디자인 화면에 컨트롤을 표시합니다.

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

다음 코드 예제에서는 파생 된 SimpleRadioButtonList 컨트롤에서 RadioButtonList 컨트롤을 사용 DesignerAttribute 하는 방법을 보여 줍니다는 디자이너와 SimpleRadioButtonListDesigner 연결 하는 SimpleRadioButtonList 클래스를 클래스입니다.

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 파생된 컨트롤을 설명하는 태그 소스 코드가 구문 분석되고 디자인 화면에서 컨트롤의 디자인 타임 버전이 만들어집니다. 사용자가 원본 보기로 다시 전환하면 디자인 타임 컨트롤이 태그 소스 코드에 유지되고 웹 페이지의 태그로 편집됩니다. 클래스는 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 컨트롤 디자이너 소개
• 연습: 웹 서버 컨트롤에 대 한 기본 컨트롤 디자이너 만들기