ListControlDataBindingHandler Classe

Definição

Namespace:

System.Web.UI.Design.WebControls

Assembly:

System.Design.dll

Executa a associação de dados de um controle de servidor Web ListControl em um designer visual.

public ref class ListControlDataBindingHandler : System::Web::UI::Design::DataBindingHandler

public class ListControlDataBindingHandler : System.Web.UI.Design.DataBindingHandler

type ListControlDataBindingHandler = class
    inherit DataBindingHandler

Public Class ListControlDataBindingHandler
Inherits DataBindingHandler

Herança

Object

DataBindingHandler

ListControlDataBindingHandler

Exemplos

Esta seção contém dois exemplos de código. O primeiro demonstra como derivar um controle do RadioButtonList controle e associá-lo ao manipulador de associação de dados. O segundo demonstra como derivar uma classe da ListControlDataBindingHandler classe .

O exemplo de código a seguir mostra como derivar o SimpleRadioButtonList controle do RadioButtonList controle e, em seguida, aplicar o DataBindingHandlerAttribute atributo para associar o SimpleRadioButtonList controle ao manipulador de associação de dados, a SimpleRadioButtonListDataBindingHandler 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

O exemplo de código a seguir mostra como derivar a SimpleRadioButtonListDataBindingHandler classe da ListControlDataBindingHandler classe . Ele substitui o DataBindControl método para adicionar uma mensagem ao controle associado SimpleRadioButtonList quando esse controle está associado a dados.

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

namespace Examples.CS.WebControls.Design
{
    // Derive the SimpleRadioButtonListDataBindingHandler.
    public class SimpleRadioButtonListDataBindingHandler : 
        ListControlDataBindingHandler
    {
        // Override the DataBindControl. 
        public override void DataBindControl(IDesignerHost designerHost, 
            Control control)
        {
            // Create a reference, named dataSourceBinding, 
            // to the control DataSource binding.
            DataBinding dataSourceBinding = 
                ((IDataBindingsAccessor)control).DataBindings["DataSource"];

            // If the binding exists, create a reference to the
            // list control, clear its ListItemCollection, and then add
            // an item to the collection.
            if (! (dataSourceBinding == null))
            {
                SimpleRadioButtonList simpleControl = 
                    (SimpleRadioButtonList)control;

                simpleControl.Items.Clear();
                simpleControl.Items.Add("Data-bound Radio Button.");
            }
        } // DataBindControl
    } // SimpleRadioButtonListDataBindingHandler
} // Examples.CS.WebControls.Design

' Imports System.Design
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Web.UI
Imports System.Web.UI.Design.WebControls

Namespace Examples.VB.WebControls.Design

    ' Derive the SimpleRadioButtonListDataBindingHandler.
    Public Class SimpleRadioButtonListDataBindingHandler
        Inherits ListControlDataBindingHandler

        ' Override the DataBindControl.
        Public Overrides Sub DataBindControl( _
        ByVal designerHost As IDesignerHost, _
        ByVal control As Control)

            ' Create a reference, named dataSourceBinding,
            ' to the control's DataSource binding.
            Dim dataSourceBinding As DataBinding _
                = CType( _
                control, _
                IDataBindingsAccessor).DataBindings("DataSource")

            ' If the binding exists, create a reference to the
            ' list control, clear its ListItemCollection, and then add
            ' an item to the collection.
            If Not (dataSourceBinding Is Nothing) Then
                Dim simpleControl As SimpleRadioButtonList = _
                    CType(control, SimpleRadioButtonList)

                simpleControl.Items.Clear()
                simpleControl.Items.Add("Data-bound Radio Button.")
            End If
        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

Comentários

A ListControlDataBindingHandler classe executa a associação de dados em tempo de design de um ListControl controle . A ListControlDataBindingHandler classe é referenciada pelo ListControl usando a DataBindingHandlerAttribute classe .

O DataBindControl método executa a associação de dados em tempo de design.

Construtores

ListControlDataBindingHandler()

Inicializa uma nova instância da classe ListControlDataBindingHandler.

Métodos

DataBindControl(IDesignerHost, Control)	Executa a associação de dados no controle especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• ListControl
• ListControlDesigner
• DataBindingHandler
• DataBindingHandlerAttribute
• Visão geral dos designers de controle de ASP.NET
• Passo a passo: criando um designer de controle básico para um controle de servidor Web
• Estendendo o suporte para tempo de design
• Como estender a aparência e o comportamento dos controles no modo de design