HierarchicalDataBoundControlDesigner Classe

Definizione

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

Ereditarietà

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

Derivato

System.Web.UI.Design.WebControls.MenuDesigner

System.Web.UI.Design.WebControls.TreeViewDesigner

Esempio

Nell'esempio di codice seguente viene illustrato come estendere la HierarchicalDataBoundControlDesigner classe per modificare l'aspetto dei controlli derivati dal HierarchicalDataBoundControl controllo in fase di progettazione.

L'esempio deriva la MyHierarchicalDataBoundControl classe da HierarchicalDataBoundControl. La MyHierarchicalDataBoundControl classe è semplicemente una copia dell'oggetto HierarchicalDataBoundControl. L'esempio deriva anche la MyHierarchicalDataBoundControlDesigner classe dalla HierarchicalDataBoundControlDesigner classe e inserisce un DesignerAttribute oggetto per nella MyHierarchicalDataBoundControlDesignerMyHierarchicalDataBoundControl classe .

Esegue MyHierarchicalDataBoundControlDesigner l'override del PreFilterProperties metodo per rendere visibile la NamingContainer proprietà nella griglia Proprietà in fase di progettazione. Esegue l'override del GetDesignTimeHtml metodo per generare il markup per un segnaposto se il markup in fase di progettazione è null o Emptyo se il markup in fase di progettazione è un blocco vuoto <span> (ovvero, se non è presente markup interno tra i <span tag ...> 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

Commenti

In un host della finestra di progettazione, quando l'utente passa dalla visualizzazione Origine a Progettazione, il codice sorgente di markup che descrive un controllo derivato dalla HierarchicalDataBoundControl classe astratta viene analizzato e viene creata una versione in fase di progettazione del controllo nell'area di progettazione. Quando l'utente torna alla visualizzazione Origine, il controllo in fase di progettazione viene salvato in modo permanente nel codice sorgente di markup e modificato nel markup per la pagina Web. La HierarchicalDataBoundControlDesigner classe fornisce il supporto in fase di progettazione per i controlli derivati da HierarchicalDataBoundControl in un host della finestra di progettazione.

Le proprietà della HierarchicalDataBoundControlDesigner classe forniscono le funzionalità seguenti:

• La ActionLists proprietà restituisce un DesignerActionListCollection oggetto , che in genere contiene un oggetto derivato dalla DesignerActionList classe per ogni livello nell'albero di ereditarietà della finestra di progettazione.

• La DataSourceDesigner proprietà fornisce l'accesso alla finestra di progettazione dell'origine dati, se definita.

• La DesignerView proprietà ottiene la visualizzazione predefinita dell'origine dati associata al controllo associato.

• La UseDataSourcePickerActionList proprietà determina se il controllo deve eseguire il rendering degli elenchi di azioni predefiniti per la scelta e la creazione di origini dati.

I metodi della HierarchicalDataBoundControlDesigner classe forniscono le funzionalità seguenti:

• Il ConnectToDataSource metodo esegue le azioni necessarie per connettersi all'origine dati corrente.

• Il CreateDataSource metodo crea una nuova origine dati per il controllo associato.

• Il DataBind metodo associa il controllo associato derivato dalla HierarchicalDataBoundControl classe a un'origine dati in fase di progettazione.

• Il DisconnectFromDataSource metodo esegue le azioni necessarie per disconnettersi dall'origine dati corrente.

• Il GetDesignTimeDataSource metodo ottiene un'origine dati che può essere utilizzata in fase di progettazione per il controllo associato.

• Il GetSampleDataSource metodo costruisce un'origine dati di esempio che può essere utilizzata in fase di progettazione per il controllo associato.

• Il PreFilterProperties metodo viene utilizzato per rimuovere le proprietà da o aggiungere proprietà aggiuntive a o alle proprietà shadow del controllo associato derivato dalla HierarchicalDataBoundControl classe .

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• HierarchicalDataBoundControl
• DataBoundControlDesigner
• Introduzione alle finestre di progettazione dei controlli di ASP.NET
• Procedura dettagliata: Creazione di un Designer di controllo di base per un controllo server Web