HierarchicalDataBoundControlDesigner Clase

Definición

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

Herencia

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

Derivado

System.Web.UI.Design.WebControls.MenuDesigner

System.Web.UI.Design.WebControls.TreeViewDesigner

Ejemplos

En el ejemplo de código siguiente se muestra cómo extender la HierarchicalDataBoundControlDesigner clase para cambiar la apariencia de los controles derivados del HierarchicalDataBoundControl control en tiempo de diseño.

En el ejemplo se deriva la MyHierarchicalDataBoundControl clase de .HierarchicalDataBoundControl La MyHierarchicalDataBoundControl clase es simplemente una copia de HierarchicalDataBoundControl. El ejemplo también deriva la MyHierarchicalDataBoundControlDesigner clase de la HierarchicalDataBoundControlDesigner clase y coloca un DesignerAttribute objeto para en MyHierarchicalDataBoundControlDesigner la MyHierarchicalDataBoundControl clase .

MyHierarchicalDataBoundControlDesigner Invalida el PreFilterProperties método para que la NamingContainer propiedad sea visible en la cuadrícula Propiedades en tiempo de diseño. Invalida el GetDesignTimeHtml método para generar el marcado de un marcador de posición si el marcado en tiempo de diseño es null o Empty, o si el marcado en tiempo de diseño es un bloque vacío <span> (es decir, si no hay ningún marcado interno entre las <span etiquetas ...> y </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

Comentarios

En un host del diseñador, cuando el usuario cambia de la vista Origen a Diseño, el código fuente de marcado que describe un control derivado de la HierarchicalDataBoundControl clase abstracta se analiza y se crea una versión en tiempo de diseño del control en la superficie de diseño. Cuando el usuario vuelve a la vista De origen, el control en tiempo de diseño se conserva en el código fuente de marcado y se edita en el marcado de la página web. La HierarchicalDataBoundControlDesigner clase proporciona compatibilidad en tiempo de diseño para los controles derivados de HierarchicalDataBoundControl en un host del diseñador.

Las HierarchicalDataBoundControlDesigner propiedades de clase proporcionan la siguiente funcionalidad:

• La ActionLists propiedad devuelve un DesignerActionListCollection objeto , que normalmente contiene un objeto derivado de la DesignerActionList clase para cada nivel del árbol de herencia del diseñador.

• La DataSourceDesigner propiedad proporciona acceso al diseñador del origen de datos, si se define uno.

• La DesignerView propiedad obtiene la vista predeterminada del origen de datos enlazado al control asociado.

• La UseDataSourcePickerActionList propiedad determina si el control debe representar sus listas de acciones predeterminadas para elegir y crear orígenes de datos.

Los HierarchicalDataBoundControlDesigner métodos de clase proporcionan la siguiente funcionalidad:

• El ConnectToDataSource método realiza las acciones necesarias para conectarse al origen de datos actual.

• El CreateDataSource método crea un nuevo origen de datos para el control asociado.

• El DataBind método enlaza el control asociado que se deriva de la HierarchicalDataBoundControl clase a un origen de datos en tiempo de diseño.

• El DisconnectFromDataSource método realiza las acciones necesarias para desconectar del origen de datos actual.

• El GetDesignTimeDataSource método obtiene un origen de datos que se puede usar en tiempo de diseño para el control asociado.

• El GetSampleDataSource método construye un origen de datos de ejemplo que se puede usar en tiempo de diseño para el control asociado.

• El PreFilterProperties método se usa para quitar propiedades de o agregar propiedades adicionales a o a las propiedades sombreadas del control asociado que se deriva de la HierarchicalDataBoundControl clase .

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• HierarchicalDataBoundControl
• DataBoundControlDesigner
• Introducción a los diseñadores de controles de ASP.NET
• Tutorial: Crear un Diseñador de controles básico para un control de servidor web