HierarchicalDataBoundControlDesigner 클래스

정의

public ref class HierarchicalDataBoundControlDesigner : System::Web::UI::Design::WebControls::BaseDataBoundControlDesigner

public class HierarchicalDataBoundControlDesigner : System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner

type HierarchicalDataBoundControlDesigner = class
    inherit BaseDataBoundControlDesigner

Public Class HierarchicalDataBoundControlDesigner
Inherits BaseDataBoundControlDesigner

상속

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

파생

System.Web.UI.Design.WebControls.MenuDesigner

System.Web.UI.Design.WebControls.TreeViewDesigner

예제

다음 코드 예제를 확장 하는 방법을 보여 줍니다 합니다 HierarchicalDataBoundControlDesigner 클래스에서 파생 되는 컨트롤의 모양을 변경 하는 HierarchicalDataBoundControl 디자인 타임에 컨트롤입니다.

이 예제에서는 파생 되는 MyHierarchicalDataBoundControl 에서 클래스를 HierarchicalDataBoundControl입니다. 합니다 MyHierarchicalDataBoundControl 클래스는 단순히 복사는 HierarchicalDataBoundControl합니다. 예제 에서도 파생 됩니다는 MyHierarchicalDataBoundControlDesigner 에서 클래스를 HierarchicalDataBoundControlDesigner 클래스 및 위치를 DesignerAttribute 개체에 대 한를 MyHierarchicalDataBoundControlDesigner 에 MyHierarchicalDataBoundControl 클래스입니다.

MyHierarchicalDataBoundControlDesigner 재정의 PreFilterProperties 메서드를 합니다 NamingContainer 속성에 표시 합니다 속성 디자인 타임에 눈금. 디자인 타임 태그가 또는 인 경우 또는 Empty디자인 타임 null 태그가 빈 <span> 블록인 경우(즉, ...> 및 </span> 태그 사이에 내부 태그가 없는 경우) 자리 표시자에 대한 태그를 생성하는 메서드를 재정 GetDesignTimeHtml 의 <span 합니다.

using System;
using System.IO;
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;

namespace Examples.CS.WebControls.Design
{
    // The MyHierarchicalDataBoundControl is a copy of the 
    // HierarchicalDataBoundControl.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.
        MyHierarchicalDataBoundControlDesigner))]
    public class MyHierarchicalDataBoundControl : 
        HierarchicalDataBoundControl
    {
    } // MyHierarchicalDataBoundControl

    // Override members of the ierarchicalDataBoundControlDesigner.
    [ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
    public class MyHierarchicalDataBoundControlDesigner : 
        HierarchicalDataBoundControlDesigner
    {
        const string bracketClose = ">";
        const string spanOpen = "<SPAN";
        const string spanClose = "</SPAN>";

        // Return the markup for a placeholder, if the inner markup is empty.
        // For brevity, the code that is used to detect embedded white_space 
        // in the tags is not shown.
        public override string GetDesignTimeHtml()
        {
            // Get the design-time markup from the base method.
            string markup = base.GetDesignTimeHtml();

            // If the markup is null or empty, return the markup 
            // for the placeholder.
            if(string.IsNullOrEmpty(markup))
                return GetEmptyDesignTimeHtml();

            // Make the markup uniform case so that the IndexOf will work.
            string MARKUP = markup.ToUpper();
            int charX;

            // Look for a <span ...> tag.
            if ((charX = MARKUP.IndexOf(spanOpen)) >= 0)
            {
                // Find closing bracket of span open tag.
                if ((charX = MARKUP.IndexOf(bracketClose, 
                        charX+spanOpen.Length)) >= 0)
                {
                    // If the inner markup of <span ...></span> is empty, 
                    // return the markup for a placeholder.
                    if (string.Compare(MARKUP, charX + 1, spanClose, 0, 
                                        spanClose.Length) == 0)

                        return GetEmptyDesignTimeHtml();
                }
            }
            // Return the original markup, if the inner markup is not empty.
            return markup;
        }

        // Shadow the control properties with design-time properties.
        protected override void PreFilterProperties(IDictionary properties)
        {
            string namingContainer = "NamingContainer";

            // Call the base method first.
            base.PreFilterProperties(properties);

            // Make the NamingContainery visible in the Properties grid.
            PropertyDescriptor selectProp =
                (PropertyDescriptor)properties[namingContainer];
            properties[namingContainer] =
                TypeDescriptor.CreateProperty(selectProp.ComponentType,
                    selectProp, BrowsableAttribute.Yes);
        } // PreFilterProperties
    } // MyHierarchicalDataBoundControlDesigner
} // Examples.CS.WebControls.Design

Imports System.IO
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 MyHierarchicalDataBoundControl is a copy of the 
    ' HierarchicalDataBoundControl.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design. _
        MyHierarchicalDataBoundControlDesigner))> _
    Public Class MyHierarchicalDataBoundControl
        Inherits HierarchicalDataBoundControl
    End Class

    ' Override members of the HierarchicalDataBoundControlDesigner.
    <ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _
    Public Class MyHierarchicalDataBoundControlDesigner
        Inherits HierarchicalDataBoundControlDesigner

        Private Const bracketClose As String = ">"
        Private Const spanOpen As String = "<SPAN"
        Private Const spanClose As String = "</SPAN>"

        ' Return the markup for a placeholder, if the inner markup is empty.
        ' For brevity, the code that is used to detect embedded white_space 
        ' in the tags is not shown.
        Public Overrides Function GetDesignTimeHtml() As String

            ' Get the design-time markup from the base method.
            Dim markup As String = MyBase.GetDesignTimeHtml()

            ' If the markup is null or empty, return the markup 
            ' for the placeholder.
            If String.IsNullOrEmpty(markup) Then
                Return GetEmptyDesignTimeHtml()
            End If

            ' Make the markup uniform case so that the IndexOf will work.
            Dim markupUC As String = markup.ToUpper()
            Dim charX As Integer

            ' Look for a <span ...> tag.
            charX = markupUC.IndexOf(spanOpen)
            If charX >= 0 Then

                ' Find closing bracket of span open tag.
                charX = markupUC.IndexOf(bracketClose, charX + spanOpen.Length)
                If charX >= 0 Then

                    ' If the inner markup of <span ...></span> is empty, 
                    ' return the markup for a placeholder.
                    If String.Compare(markupUC, charX + 1, _
                        spanClose, 0, spanClose.Length) = 0 Then

                        Return GetEmptyDesignTimeHtml()
                    End If
                End If
            End If

            ' Return the original markup, if the inner markup is not empty.
            Return markup
        End Function ' GetDesignTimeHtml

        ' Shadow the control properties with design-time properties.
        Protected Overrides Sub PreFilterProperties( _
            ByVal properties As IDictionary)

            Dim namingContainer As String = "NamingContainer"

            ' Call the base method first.
            MyBase.PreFilterProperties(properties)

            ' Make the NamingContainery visible in the Properties grid.
            Dim selectProp As PropertyDescriptor = _
                CType(properties(namingContainer), PropertyDescriptor)
            properties(namingContainer) = _
                TypeDescriptor.CreateProperty(selectProp.ComponentType, _
                    selectProp, BrowsableAttribute.Yes)
        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

설명

디자이너 호스트에서 사용자가 소스 뷰에서 디자인 뷰로 전환 하는 경우 태그 소스 코드를 설명 하는 컨트롤에서 파생 되는 HierarchicalDataBoundControl 추상 클래스는 구문 분석 하 고 디자인 화면에서 컨트롤의 디자인 타임 버전을 만들어집니다. 사용자가 소스 뷰로 다시 전환, 디자인 타임 컨트롤 태그 소스 코드에 유지 되 고 웹 페이지에 대 한 태그를 편집 합니다. 합니다 HierarchicalDataBoundControlDesigner 클래스에서 파생 되는 컨트롤에 대 한 디자인 타임 지원을 제공 합니다 HierarchicalDataBoundControl 디자이너 호스트에서입니다.

HierarchicalDataBoundControlDesigner 클래스 속성에는 다음 기능을 제공 합니다.

• ActionLists 속성에서 반환을 DesignerActionListCollection 일반적으로에서 파생 된 개체를 포함 하는 개체는 DesignerActionList 디자이너의 상속 트리의 각 수준에 대 한 클래스입니다.

• DataSourceDesigner 속성 정의 된 경우 데이터 원본 디자이너에 액세스를 제공 합니다.

• DesignerView 속성에 연결된 된 컨트롤에 바인딩되는 데이터 소스의 기본 뷰를 가져옵니다.

• UseDataSourcePickerActionList 속성 컨트롤 선택 하 고 데이터 원본 만들기에 대 한 기본 작업 목록을 렌더링 해야 하는지 여부를 결정 합니다.

HierarchicalDataBoundControlDesigner 클래스 메서드는 다음 기능을 제공 합니다.

• ConnectToDataSource 메서드는 현재 데이터 소스에 연결 하는 데 필요한 작업을 수행 합니다.

• CreateDataSource 메서드는 연결된 된 컨트롤에 대 한 새 데이터 원본을 만듭니다.

• DataBind 메서드에서 파생 되는 연결된 된 컨트롤을 바인딩하는 HierarchicalDataBoundControl 디자인 타임 데이터 원본에 대 한 클래스입니다.

• DisconnectFromDataSource 메서드는 현재 데이터 소스에서 분리 하는 데 필요한 작업을 수행 합니다.

• GetDesignTimeDataSource 메서드는 연결된 된 컨트롤에 대 한 디자인 타임에 사용할 수 있는 데이터 소스를 가져옵니다.

• GetSampleDataSource 메서드는 연결된 된 컨트롤에 대 한 디자인 타임에 사용할 수 있는 샘플 데이터 소스를 생성 합니다.

• 합니다 PreFilterProperties 메서드는 속성을 제거 또는 추가 하거나에서 파생 되는 연결된 된 컨트롤의 속성을 숨기는 데는 HierarchicalDataBoundControl 클래스입니다.

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 정보

• HierarchicalDataBoundControl
• DataBoundControlDesigner
• ASP.NET 컨트롤 디자이너 소개
• 연습: 웹 서버 컨트롤에 대 한 기본 컨트롤 디자이너 만들기