HierarchicalDataBoundControlDesigner Classe

Definição

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

Herança

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

Derivado

System.Web.UI.Design.WebControls.MenuDesigner

System.Web.UI.Design.WebControls.TreeViewDesigner

Exemplos

O exemplo de código seguinte mostra como estender a HierarchicalDataBoundControlDesigner classe para alterar a aparência dos controlos derivados do HierarchicalDataBoundControl controlo no momento do projeto.

O exemplo deriva a MyHierarchicalDataBoundControl classe a partir do HierarchicalDataBoundControl. A MyHierarchicalDataBoundControl classe é simplesmente uma cópia do HierarchicalDataBoundControl. O exemplo também deriva a MyHierarchicalDataBoundControlDesigner classe a partir da HierarchicalDataBoundControlDesigner classe e coloca um DesignerAttribute objeto para o MyHierarchicalDataBoundControlDesigner na MyHierarchicalDataBoundControl classe.

Sobrepõe-se MyHierarchicalDataBoundControlDesigner ao PreFilterProperties método para tornar a NamingContainer propriedade visível na grelha de Propriedades no momento do projeto. Sobrepõe-se ao GetDesignTimeHtml método de gerar a marcação para um marcador de lugar se a marcação em tempo de design for null ou Empty, ou se a marcação em tempo de design for um bloco vazio <span> (isto é, se não houver marcação interna entre as <span etiquetas ...> e </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

Observações

Num host designer, quando o utilizador muda da vista Source para a vista Design, o código-fonte de marcação que descreve um controlo derivado da HierarchicalDataBoundControl classe abstrata é analisado e uma versão em tempo de design do controlo é criada na superfície de design. Quando o utilizador regressa à vista de código-fonte, o controlo de tempo de design é mantido para marcar o código-fonte e ser editado na marcação da página Web. A HierarchicalDataBoundControlDesigner classe fornece suporte em tempo de projeto para controlos derivados do HierarchicalDataBoundControl num host projetado.

As HierarchicalDataBoundControlDesigner propriedades da classe fornecem a seguinte funcionalidade:

• A ActionLists propriedade devolve um DesignerActionListCollection objeto, que normalmente contém um objeto derivado da DesignerActionList classe para cada nível na árvore de herança do designer.

• A DataSourceDesigner propriedade fornece acesso ao projetista da fonte de dados, se for definido.

• A DesignerView propriedade obtém a vista padrão da fonte de dados que está ligada ao controlo associado.

• A UseDataSourcePickerActionList propriedade determina se o controlo deve renderizar as suas listas de ações predefinidas para escolher e criar fontes de dados.

Os HierarchicalDataBoundControlDesigner métodos de classe fornecem a seguinte funcionalidade:

• O ConnectToDataSource método realiza as ações necessárias para se ligar à fonte de dados atual.

• O CreateDataSource método cria uma nova fonte de dados para o controlo associado.

• O DataBind método vincula o controlo associado derivado da HierarchicalDataBoundControl classe a uma fonte de dados em tempo de design.

• O DisconnectFromDataSource método executa as ações necessárias para se desligar da fonte de dados atual.

• O GetDesignTimeDataSource método obtém uma fonte de dados que pode ser usada no momento do design para o controlo associado.

• O GetSampleDataSource método constrói uma fonte de dados de amostra que pode ser usada no momento do design para o controlo associado.

• O PreFilterProperties método é usado para remover propriedades ou adicionar propriedades adicionais ou para propriedades de sombra do controlo associado que é derivado da HierarchicalDataBoundControl classe.

Ver também

• HierarchicalDataBoundControl
• DataBoundControlDesigner
• Introdução aos Designers de Controlo ASP.NET
• Guia: Criar um Designer Básico de Controlo para um Controlo de Servidor Web