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. В этом примере класс также является производным MyHierarchicalDataBoundControlDesignerHierarchicalDataBoundControlDesigner от класса и помещает DesignerAttribute объект для в MyHierarchicalDataBoundControlDesignerMyHierarchicalDataBoundControl класс .

Переопределяет MyHierarchicalDataBoundControlDesigner метод , PreFilterProperties чтобы сделать NamingContainer свойство видимым в сетке Свойства во время разработки. Он переопределяет GetDesignTimeHtml метод для создания разметки для заполнителя, если разметка времени разработки имеет значение null или Empty, или если разметка времени разработки является пустым <span> блоком (т. е. если между <span тегами ...> и </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
• Пошаговое руководство. Создание базового конструктора элементов управления для серверного веб-элемента управления