ListControlDataBindingHandler Класс

Определение

Пространство имен:

System.Web.UI.Design.WebControls

Сборка:

System.Design.dll

Выполняет привязку данных для ListControl серверного веб-элемента управления в визуальном конструкторе.

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

Наследование

Object

DataBindingHandler

ListControlDataBindingHandler

Примеры

Этот раздел содержит два примера кода. В первом из них показано, как наследовать элемент управления из RadioButtonList элемента управления и связать его с обработчиком привязки данных. Во втором из них показано, как наследовать класс от ListControlDataBindingHandler класса .

В следующем примере кода показано, как наследовать SimpleRadioButtonList элемент управления от RadioButtonList элемента управления , а затем применить DataBindingHandlerAttribute атрибут , чтобы связать SimpleRadioButtonList элемент управления с его обработчиком привязки данных, классом SimpleRadioButtonListDataBindingHandler .

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

В следующем примере кода показано, как наследовать SimpleRadioButtonListDataBindingHandler класс от ListControlDataBindingHandler класса . Он переопределяет DataBindControl метод для добавления сообщения в связанный SimpleRadioButtonList элемент управления, когда этот элемент управления привязан к данным.

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

Комментарии

Класс ListControlDataBindingHandler выполняет привязку ListControl данных элемента управления во время разработки. На ListControlDataBindingHandler класс ссылается с помощью ListControlDataBindingHandlerAttribute класса .

Метод DataBindControl выполняет привязку данных во время разработки.

Конструкторы

ListControlDataBindingHandler()

Инициализирует новый экземпляр класса ListControlDataBindingHandler.

Методы

DataBindControl(IDesignerHost, Control)	Выполняет привязку данных для указанного элемента управления.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• ListControl
• ListControlDesigner
• DataBindingHandler
• DataBindingHandlerAttribute
• Общие сведения о конструкторах элементов управления ASP.NET
• Пошаговое руководство. Создание базового конструктора элементов управления для серверного веб-элемента управления
• Расширение поддержки времени разработки
• Практическое руководство. Расширение внешнего вида и функциональности элементов управления в режиме конструктора