ListControlDesigner Classe

Definição

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

Herança

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

ListControlDesigner

Herança

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

ListControlDesigner

Derivado

System.Web.UI.Design.WebControls.BulletedListDesigner

Atributos

SupportsPreviewControlAttribute

Implementações

IDataSourceProvider

Exemplos

Esta secção fornece dois exemplos de código. O primeiro demonstra como derivar um designer de controlo personalizado. A segunda demonstra como associar um controlo derivado a um designer.

O seguinte exemplo de código mostra como criar uma classe nomeada SimpleRadioButtonListDesigner que herda da ListControlDesigner classe. A SimpleRadioButtonListDesigner classe sobrepõe-se aos GetDesignTimeHtmlmétodos , Initialize, e OnDataSourceChanged . A SimpleRadioButtonListDesigner classe apresenta um SimpleRadioButtonList controlo na superfície de design.

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

O exemplo de código seguinte deriva o SimpleRadioButtonList controlo a partir do RadioButtonList controlo e mostra como usar a DesignerAttribute classe para associar o SimpleRadioButtonList controlo ao seu designer, a SimpleRadioButtonListDesigner classe.

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

Observações

No Visual Web Designer, quando o utilizador muda da vista de Fonte para a vista de Design, o código-fonte de marcação que descreve um controlo derivado da ListControl classe é analisado e uma versão em tempo de design do controlo é criada na superfície de design. Quando o utilizador volta para a vista Fonte, o controlo de tempo de design é mantido no código-fonte da marcação e editado na marcação da página Web. A ListControlDesigner classe serve como classe base para designers que fornecem suporte em tempo de design no Visual Web Designer para controlos derivados do ListControl.

As ListControlDesigner propriedades da classe fornecem a seguinte funcionalidade:

• A ActionLists propriedade devolve um DesignerActionListCollection objeto, que normalmente contém um objeto derivado do DesignerActionList objeto para cada nível na árvore de herança do designer.

• As DataTextField propriedades e DataValueField fornecem acesso às propriedades correspondentes de um controlo derivado da ListControl classe. Os DataTextField e DataValueField indicam os campos da fonte de dados que fornecem o texto e o conteúdo de valores dos itens da lista, respetivamente.

Os ListControlDesigner métodos de classe fornecem a seguinte funcionalidade:

• O DataBind método liga o controlo associado derivado do ListControl a uma fonte de dados em tempo de projeto.

• O GetDesignTimeHtml método devolve a marcação que é usada para renderizar o controlo associado no momento do design.

• O GetSelectedDataSource método devolve o componente de tempo DataSource de projeto do contentor de controlo associado.

• O GetResolvedSelectedDataSource método devolve o DataSource do contentor de controlo, resolvido para a propriedade de tempo DataMember de projeto do controlo.

• O Initialize método prepara o projetista para visualizar e projetar o controlo associado que é derivado do ListControl.

• O OnDataSourceChanged método é chamado quando o DataSource para o controlo associado mudou.

• O PreFilterProperties método é usado para remover propriedades adicionais de, adicionar propriedades adicionais ou propriedades de sombra do controlo associado que é derivado do ListControl.

Ver também

• ListControl
• DataBoundControl
• DataBoundControlDesigner
• BaseDataBoundControl
• BaseDataBoundControlDesigner
• WebControl
• ControlDesigner
• Introdução aos Designers de Controlo ASP.NET
• Guia: Criar um Designer Básico de Controlo para um Controlo de Servidor Web