HierarchicalDataBoundControlDesigner Classe

Définition

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

Héritage

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

Dérivé

System.Web.UI.Design.WebControls.MenuDesigner

System.Web.UI.Design.WebControls.TreeViewDesigner

Exemples

L’exemple de code suivant montre comment étendre la HierarchicalDataBoundControlDesigner classe pour modifier l’apparence des contrôles dérivés du contrôle au moment du HierarchicalDataBoundControl design.

L’exemple dérive la MyHierarchicalDataBoundControl classe de .HierarchicalDataBoundControl La MyHierarchicalDataBoundControl classe est simplement une copie de .HierarchicalDataBoundControl L’exemple dérive également la MyHierarchicalDataBoundControlDesigner classe de la HierarchicalDataBoundControlDesigner classe et place un DesignerAttribute objet pour le MyHierarchicalDataBoundControlDesigner sur la MyHierarchicalDataBoundControl classe .

remplace MyHierarchicalDataBoundControlDesigner la PreFilterProperties méthode pour rendre la NamingContainer propriété visible dans la grille Propriétés au moment du design. Il remplace la GetDesignTimeHtml méthode pour générer le balisage d’un espace réservé si le balisage au moment de la conception est null ou Empty, ou si le balisage au moment du design est un bloc vide <span> (autrement dit, s’il n’y a pas de balisage interne entre les <span balises ...> et </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

Remarques

Dans un hôte de concepteur, lorsque l’utilisateur passe du mode Source au mode Création, le code source de balisage qui décrit un contrôle dérivé de la HierarchicalDataBoundControl classe abstraite est analysé et une version au moment du design du contrôle est créée sur l’aire de conception. Lorsque l’utilisateur revient en mode Source, le contrôle au moment du design est conservé dans le code source du balisage et modifié dans le balisage de la page Web. La HierarchicalDataBoundControlDesigner classe fournit une prise en charge au moment du design pour les contrôles dérivés du HierarchicalDataBoundControl dans un hôte de concepteur.

Les HierarchicalDataBoundControlDesigner propriétés de classe fournissent les fonctionnalités suivantes :

• La ActionLists propriété retourne un DesignerActionListCollection objet, qui contient généralement un objet dérivé de la DesignerActionList classe pour chaque niveau de l’arborescence d’héritage du concepteur.

• La DataSourceDesigner propriété fournit l’accès au concepteur de la source de données, le cas échéant.

• La DesignerView propriété obtient la vue par défaut de la source de données liée au contrôle associé.

• La UseDataSourcePickerActionList propriété détermine si le contrôle doit afficher ses listes d’actions par défaut pour le choix et la création de sources de données.

Les HierarchicalDataBoundControlDesigner méthodes de classe fournissent les fonctionnalités suivantes :

• La ConnectToDataSource méthode effectue les actions nécessaires pour se connecter à la source de données actuelle.

• La CreateDataSource méthode crée une source de données pour le contrôle associé.

• La DataBind méthode lie le contrôle associé dérivé de la HierarchicalDataBoundControl classe à une source de données au moment du design.

• La DisconnectFromDataSource méthode effectue les actions nécessaires pour se déconnecter de la source de données actuelle.

• La GetDesignTimeDataSource méthode obtient une source de données qui peut être utilisée au moment du design pour le contrôle associé.

• La GetSampleDataSource méthode construit un exemple de source de données qui peut être utilisé au moment du design pour le contrôle associé.

• La PreFilterProperties méthode permet de supprimer ou d’ajouter des propriétés supplémentaires aux propriétés d’ombre du contrôle associé dérivé de la HierarchicalDataBoundControl classe .

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• HierarchicalDataBoundControl
• DataBoundControlDesigner
• Présentation des concepteurs de contrôles ASP.NET
• Procédure pas à pas : création d’un Designer de contrôle de base pour un contrôle serveur web