HierarchicalDataBoundControlDesigner Klasa

Definicja

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

Dziedziczenie

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

Pochodne

System.Web.UI.Design.WebControls.MenuDesigner

System.Web.UI.Design.WebControls.TreeViewDesigner

Przykłady

W poniższym przykładzie kodu pokazano, jak rozszerzyć klasę HierarchicalDataBoundControlDesigner w celu zmiany wyglądu kontrolek pochodzących z kontrolki HierarchicalDataBoundControl w czasie projektowania.

Przykład wyprowadza klasę MyHierarchicalDataBoundControl z klasy HierarchicalDataBoundControl. Klasa MyHierarchicalDataBoundControl jest po prostu kopią elementu HierarchicalDataBoundControl. Przykład wyprowadza również klasę MyHierarchicalDataBoundControlDesigner z HierarchicalDataBoundControlDesigner klasy i umieszcza DesignerAttribute obiekt dla MyHierarchicalDataBoundControlDesigner klasy w MyHierarchicalDataBoundControl klasie.

Zastępuje MyHierarchicalDataBoundControlDesigner metodę PreFilterProperties , aby właściwość widoczna NamingContainer w siatce Właściwości w czasie projektowania. GetDesignTimeHtml Zastępuje metodę generowania znaczników dla symbolu zastępczego, jeśli znacznik czasu projektowania to null lub Empty, lub jeśli znacznik czasu projektowania jest pustym <span> blokiem (oznacza to, że nie ma wewnętrznego znacznika między znacznikami <span ...> i </span> tagami).

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

Uwagi

Na hoście projektanta, gdy użytkownik przełącza się z widoku Źródło do widoku projektu, kod źródłowy znaczników opisujący kontrolkę pochodzącą z HierarchicalDataBoundControl klasy abstrakcyjnej jest analizowany, a wersja czasu projektowania kontrolki jest tworzona na powierzchni projektowej. Gdy użytkownik przełączy się z powrotem do widoku źródła, kontrolka czasu projektowania jest utrwalana w celu znaczników kodu źródłowego i edytowana w znacznikach dla strony sieci Web. Klasa HierarchicalDataBoundControlDesigner zapewnia obsługę czasu projektowania kontrolek pochodzących z HierarchicalDataBoundControl hosta projektanta.

Właściwości HierarchicalDataBoundControlDesigner klasy zapewniają następujące funkcje:

• Właściwość ActionLists zwraca DesignerActionListCollection obiekt, który zazwyczaj zawiera obiekt pochodzący z DesignerActionList klasy dla każdego poziomu w drzewie dziedziczenia projektanta.

• Właściwość DataSourceDesigner zapewnia dostęp do projektanta źródła danych, jeśli jest zdefiniowany.

• Właściwość DesignerView pobiera domyślny widok źródła danych powiązanego ze skojarzona kontrolką.

• Właściwość określa, czy kontrolka UseDataSourcePickerActionList powinna renderować domyślne listy akcji do wybierania i tworzenia źródeł danych.

Metody HierarchicalDataBoundControlDesigner klasy zapewniają następujące funkcje:

• Metoda ConnectToDataSource wykonuje akcje niezbędne do nawiązania połączenia z bieżącym źródłem danych.

• Metoda CreateDataSource tworzy nowe źródło danych dla skojarzonej kontrolki.

• Metoda DataBind wiąże skojarzona kontrolka, która pochodzi z HierarchicalDataBoundControl klasy do źródła danych w czasie projektowania.

• Metoda DisconnectFromDataSource wykonuje akcje niezbędne do odłączenia od bieżącego źródła danych.

• Metoda GetDesignTimeDataSource pobiera źródło danych, które może być używane w czasie projektowania skojarzonej kontrolki.

• Metoda GetSampleDataSource tworzy przykładowe źródło danych, które może być używane w czasie projektowania dla skojarzonej kontrolki.

• Metoda PreFilterProperties służy do usuwania właściwości z klasy lub dodawania dodatkowych właściwości do lub do właściwości w tle skojarzonej kontrolki pochodzącej HierarchicalDataBoundControl z klasy.

Konstruktory

Właściwości

Metody

Jawne implementacje interfejsu

Dotyczy

Zobacz też

• HierarchicalDataBoundControl
• DataBoundControlDesigner
• Wprowadzenie do projektantów kontrolek ASP.NET
• Przewodnik: tworzenie Projektant podstawowej kontrolki dla kontrolki serwera sieci Web