ListControlDesigner Klass

Definition

public ref class ListControlDesigner : System::Web::UI::Design::ControlDesigner, System::Web::UI::Design::IDataSourceProvider

public ref class ListControlDesigner : System::Web::UI::Design::WebControls::DataBoundControlDesigner

public class ListControlDesigner : System.Web.UI.Design.ControlDesigner, System.Web.UI.Design.IDataSourceProvider

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class ListControlDesigner : System.Web.UI.Design.WebControls.DataBoundControlDesigner

type ListControlDesigner = class
    inherit ControlDesigner
    interface IDataSourceProvider

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type ListControlDesigner = class
    inherit DataBoundControlDesigner

Public Class ListControlDesigner
Inherits ControlDesigner
Implements IDataSourceProvider

Public Class ListControlDesigner
Inherits DataBoundControlDesigner

Arv

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

ListControlDesigner

Arv

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

ListControlDesigner

Härledda

System.Web.UI.Design.WebControls.BulletedListDesigner

Attribut

SupportsPreviewControlAttribute

Implementeringar

IDataSourceProvider

Exempel

Det här avsnittet innehåller två kodexempel. Den första visar hur du härleder en anpassad kontrolldesigner. Den andra visar hur du associerar en härledd kontroll med en designer.

I följande kodexempel visas hur du skapar en klass med namnet SimpleRadioButtonListDesigner som ärver från ListControlDesigner klassen. Klassen SimpleRadioButtonListDesigner åsidosätter GetDesignTimeHtmlmetoderna , Initializeoch OnDataSourceChanged . Klassen SimpleRadioButtonListDesigner visar en SimpleRadioButtonList kontroll på designytan.

using System;
using System.ComponentModel;
using System.Drawing;
using System.Diagnostics;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;

namespace Examples.CS.WebControls.Design
{
    // Create the SimpleRadioButtonListDesigner, which provides
    // design-time support for a custom list class.
    public class SimpleRadioButtonListDesigner : ListControlDesigner
    {
        SimpleRadioButtonList simpleRadioButtonList;
        bool changedDataSource;

        // Create the markup to display the control on the design surface. 
        public override string GetDesignTimeHtml()
        {
            string designTimeMarkup = null;

            // Create variables to access the control
            // item collection and back color.
            ListItemCollection items = simpleRadioButtonList.Items;
            Color oldBackColor = simpleRadioButtonList.BackColor;

            // Check the property values and render the markup
            // on the design surface accordingly.
            try
            {
                if (oldBackColor == Color.Empty)
                    simpleRadioButtonList.BackColor = Color.Gainsboro;

                if (changedDataSource)
                    items.Add("Updated to a new data source: " + 
                        DataSource + ".");

                // Call the base method to generate the markup.
                designTimeMarkup = base.GetDesignTimeHtml();
            }
            catch (Exception ex)
            {
                // Catch any exceptions that occur.
                designTimeMarkup = GetErrorDesignTimeHtml(ex);
            }
            finally
            {
                // Set the properties back to their original state.
                simpleRadioButtonList.BackColor = oldBackColor;
                items.Clear();
            }

            return designTimeMarkup;
        } // GetDesignTimeHtml

        public override void Initialize(IComponent component)
        {
            // Ensure that only a SimpleRadioButtonList can be 
            // created in this designer.
            Debug.Assert( 
                component is SimpleRadioButtonList, 
                "An invalid SimpleRadioButtonList control was initialized.");

            simpleRadioButtonList = (SimpleRadioButtonList)component;
            base.Initialize(component);
        } // Initialize

        // If the data source changes, set a boolean variable.
        public override void OnDataSourceChanged()
        {
            changedDataSource = true;
        } // OnDataSourceChanged
    } // SimpleRadioButtonListDesigner
} // Examples.CS.WebControls.Design

Imports System.ComponentModel
Imports System.Drawing
Imports System.Diagnostics
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls

Namespace Examples.VB.WebControls.Design

    ' Create the SimpleRadioButtonListDesigner, which provides
    ' design-time support for a custom list class.  
    Public Class SimpleRadioButtonListDesigner
        Inherits ListControlDesigner

        Private simpleRadioButtonList As SimpleRadioButtonList
        Private changedDataSource As Boolean

        ' Create the markup to display the control on the design surface.
        Public Overrides Function GetDesignTimeHtml() As String

            Dim designTimeHtml As String = String.Empty

            ' Create variables to access the control's
            ' item collection and back color. 
            Dim items As ListItemCollection = simpleRadioButtonList.Items
            Dim oldBackColor As Color = simpleRadioButtonList.BackColor

            ' Check the property values and render the markup
            ' on the design surface accordingly.
            Try
                If (Color.op_Equality(oldBackColor, Color.Empty)) Then
                    simpleRadioButtonList.BackColor = Color.Gainsboro
                End If

                If (changedDataSource) Then
                    items.Add( _
                        "Updated to a new data source: " & DataSource & ".")
                End If

                designTimeHtml = MyBase.GetDesignTimeHtml()

            Catch ex As Exception
                ' Catch any exceptions that occur.
                MyBase.GetErrorDesignTimeHtml(ex)

            Finally
                ' Set the properties back to their original state.
                simpleRadioButtonList.BackColor = oldBackColor
                items.Clear()
            End Try

            Return designTimeHtml
        End Function ' GetDesignTimeHtml

        Public Overrides Sub Initialize(ByVal component As IComponent)

            ' Ensure that only a SimpleRadioButtonList can be created 
            ' in this designer.
            Debug.Assert( _
                TypeOf component Is SimpleRadioButtonList, _
                "An invalid SimpleRadioButtonList control was initialized.")

            simpleRadioButtonList = CType(component, SimpleRadioButtonList)
            MyBase.Initialize(component)
        End Sub

        ' If the data source changes, set a Boolean variable.
        Public Overrides Sub OnDataSourceChanged()
            changedDataSource = True
        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

Följande kodexempel härleder SimpleRadioButtonList kontrollen från RadioButtonList kontrollen och visar hur du använder DesignerAttribute klassen för att associera SimpleRadioButtonList kontrollen med dess designer, SimpleRadioButtonListDesigner klassen.

using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The SimpleRadioButtonList is a copy of the RadioButtonList.
    // It uses the SimpleRadioButtonListDesigner for design-time support.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.
       SimpleRadioButtonListDesigner))]
    [DataBindingHandler(typeof(Examples.CS.WebControls.Design.
        SimpleRadioButtonListDataBindingHandler))]
    public class SimpleRadioButtonList : RadioButtonList
    {
    } // SimpleRadioButtonList
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The SimpleRadioButtonList is a copy of the RadioButtonList.
    ' It uses the SimpleRadioButtonListDesigner for design-time support.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <DesignerAttribute(GetType(Examples.VB.WebControls.Design. _
        SimpleRadioButtonListDesigner))> _
    <DataBindingHandler(GetType(Examples.VB.WebControls.Design. _
        SimpleRadioButtonListDataBindingHandler))> _
    Public Class SimpleRadioButtonList
        Inherits RadioButtonList
    End Class
End Namespace ' Examples.VB.WebControls.Design

Kommentarer

När användaren växlar från käll- till designvyn i Visual Web Designer parsas källkoden som beskriver en kontroll som härleds från ListControl klassen och en designtidsversion av kontrollen skapas på designytan. När användaren växlar tillbaka till källvyn sparas designtidskontrollen till koden för markeringskällan och redigeras till markering för webbsidan. Klassen ListControlDesigner fungerar som basklass för designers som tillhandahåller designtidsstöd i Visual Web Designer för kontroller som härleds från ListControl.

Klassegenskaperna ListControlDesigner tillhandahåller följande funktioner:

• Egenskapen ActionLists returnerar ett DesignerActionListCollection objekt som vanligtvis innehåller ett objekt som härleds från DesignerActionList objektet för varje nivå i designerns arvsträd.

• Egenskaperna DataTextField och DataValueField ger åtkomst till motsvarande egenskaper för en kontroll som härleds från ListControl klassen. Och DataTextFieldDataValueField anger fälten för datakällan som anger text- respektive värdeinnehållet för listobjekten.

Klassmetoderna ListControlDesigner tillhandahåller följande funktioner:

• Metoden DataBind binder den associerade kontrollen som härleds från ListControl till en datakälla för designtid.

• Metoden GetDesignTimeHtml returnerar den markering som används för att återge den associerade kontrollen vid designtillfället.

• Metoden GetSelectedDataSource returnerar komponenten design-time DataSource från den associerade kontrollcontainern.

• Metoden GetResolvedSelectedDataSource returnerar DataSource från kontrollcontainern, matchad till kontrollens designtidsegenskap DataMember .

• Metoden Initialize förbereder designern för att visa och utforma den associerade kontroll som härleds från ListControl.

• Metoden OnDataSourceChanged anropas när DataSource för den associerade kontrollen har ändrats.

• Metoden PreFilterProperties används för att ta bort ytterligare egenskaper från, lägga till ytterligare egenskaper i eller skuggegenskaper för den associerade kontrollen som härleds från ListControl.

Se även

• ListControl
• DataBoundControl
• DataBoundControlDesigner
• BaseDataBoundControl
• BaseDataBoundControlDesigner
• WebControl
• ControlDesigner
• Introduction till ASP.NET Control Designers
• Genomgång: Skapa en grundläggande kontrolldesigner för en webbserverkontroll