HierarchicalDataBoundControlDesigner Klasse

Definition

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

Vererbung

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

HierarchicalDataBoundControlDesigner

Abgeleitet

System.Web.UI.Design.WebControls.MenuDesigner

System.Web.UI.Design.WebControls.TreeViewDesigner

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die HierarchicalDataBoundControlDesigner -Klasse erweitern, um die Darstellung von Steuerelementen zu ändern, die HierarchicalDataBoundControl zur Entwurfszeit vom Steuerelement abgeleitet werden.

Im Beispiel wird die MyHierarchicalDataBoundControl -Klasse von HierarchicalDataBoundControlabgeleitet. Die MyHierarchicalDataBoundControl -Klasse ist einfach eine Kopie von HierarchicalDataBoundControl. Im Beispiel wird auch die MyHierarchicalDataBoundControlDesigner -Klasse von der HierarchicalDataBoundControlDesigner -Klasse abgeleitet und ein DesignerAttribute -Objekt für die MyHierarchicalDataBoundControlDesignerMyHierarchicalDataBoundControl -Klasse platziert.

Überschreibt MyHierarchicalDataBoundControlDesigner die PreFilterProperties -Methode, um die NamingContainer Eigenschaft zur Entwurfszeit im Eigenschaftenraster sichtbar zu machen. Es überschreibt die GetDesignTimeHtml -Methode, um das Markup für einen Platzhalter zu generieren, wenn das Entwurfszeitmarkup null oder Emptyist oder wenn das Entwurfszeitmarkup ein leerer <span> Block ist (d. a. wenn kein inneres Markup zwischen den <span Tags ...> und </span> vorhanden ist).

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

Hinweise

Wenn der Benutzer auf einem Designerhost von der Quell- zur Entwurfsansicht wechselt, wird der Markupquellcode, der ein von der HierarchicalDataBoundControl abstrakten Klasse abgeleitetes Steuerelement beschreibt, analysiert, und eine Entwurfszeitversion des Steuerelements wird auf der Entwurfsoberfläche erstellt. Wenn der Benutzer zurück zur Quellansicht wechselt, wird das Entwurfszeit-Steuerelement beibehalten, um Quellcode zu markupen und im Markup für die Webseite zu bearbeiten. Die HierarchicalDataBoundControlDesigner -Klasse bietet Entwurfszeitunterstützung für Steuerelemente, die von in HierarchicalDataBoundControl einem Designerhost abgeleitet werden.

Die HierarchicalDataBoundControlDesigner Klasseneigenschaften bieten die folgenden Funktionen:

• Die ActionLists -Eigenschaft gibt ein DesignerActionListCollection -Objekt zurück, das in der Regel ein Objekt enthält, das von der DesignerActionList -Klasse für jede Ebene in der Vererbungsstruktur des Designers abgeleitet wird.

• Die DataSourceDesigner -Eigenschaft bietet Zugriff auf den Designer der Datenquelle, sofern definiert.

• Die DesignerView -Eigenschaft ruft die Standardansicht der Datenquelle ab, die an das zugeordnete Steuerelement gebunden ist.

• Die UseDataSourcePickerActionList -Eigenschaft bestimmt, ob das Steuerelement seine Standardaktionslisten zum Auswählen und Erstellen von Datenquellen rendern soll.

Die HierarchicalDataBoundControlDesigner Klassenmethoden bieten die folgenden Funktionen:

• Die ConnectToDataSource -Methode führt die Aktionen aus, die zum Herstellen einer Verbindung mit der aktuellen Datenquelle erforderlich sind.

• Die CreateDataSource -Methode erstellt eine neue Datenquelle für das zugeordnete Steuerelement.

• Die DataBind -Methode bindet das zugeordnete Steuerelement, das von der HierarchicalDataBoundControl -Klasse abgeleitet wird, an eine Entwurfszeitdatenquelle.

• Die DisconnectFromDataSource -Methode führt die Aktionen aus, die erforderlich sind, um die Verbindung mit der aktuellen Datenquelle zu trennen.

• Die GetDesignTimeDataSource -Methode ruft eine Datenquelle ab, die zur Entwurfszeit für das zugeordnete Steuerelement verwendet werden kann.

• Die GetSampleDataSource -Methode erstellt eine Beispieldatenquelle, die zur Entwurfszeit für das zugeordnete Steuerelement verwendet werden kann.

• Die PreFilterProperties -Methode wird verwendet, um Eigenschaften aus dem zugeordneten Steuerelement zu entfernen oder zusätzliche Eigenschaften zu oder hinzuzufügen, um Eigenschaften des zugeordneten Steuerelements, das von der HierarchicalDataBoundControl -Klasse abgeleitet wird, zu überschatten.

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

• HierarchicalDataBoundControl
• DataBoundControlDesigner
• Einführung in ASP.NET Control Designer
• Exemplarische Vorgehensweise: Erstellen eines Einfachen Steuerelement-Designers für ein Webserversteuerelement