DataBindingHandler Class (System.Web.UI.Design)

Switch View :
ScriptFree
.NET Framework Class Library
DataBindingHandler Class

Provides a base class for a data-binding handler.

Namespace:  System.Web.UI.Design
Assembly:  System.Design (in System.Design.dll)
Syntax

Visual Basic (Declaration)
<SecurityPermissionAttribute(SecurityAction.Demand, Flags := SecurityPermissionFlag.UnmanagedCode)> _
Public MustInherit Class DataBindingHandler
Visual Basic (Usage)
Dim instance As DataBindingHandler
C#
[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public abstract class DataBindingHandler
Visual C++
[SecurityPermissionAttribute(SecurityAction::Demand, Flags = SecurityPermissionFlag::UnmanagedCode)]
public ref class DataBindingHandler abstract
JScript
public abstract class DataBindingHandler
Remarks

DataBindingHandler provides a base class for data-binding handlers. A data-binding handler can be used within a designer to perform data-binding to enable a meaningful display of the control on the design surface. Typically a control's designer is responsible for this functionality. However, when a control is not live on the design surface, such as within the template of another control, it does not have a designer, and this functionality is provided by a data-binding handler if one has been specified with a DataBindingHandlerAttribute in the code for the control.

To use a data-binding handler, the control which has the data-bound property or properties must have a DataBindingHandlerAttribute specified within its code that indicates the type of data-binding handler to use.

For example, the Label control is associated with the TextDataBindingHandler class through a DataBindingHandlerAttribute in the code for the Label class. Within a template for a DataList, a Label control whose text property has been data bound displays the word "DataBound" on the label. Without the data-binding handler, the label would be invisible at design-time, as it does not have a designer to bind its data-bound properties while in a templated control at design-time.

To implement a data-binding handler, define a new class that derives from this class and implement the DataBindControl method to set the appropriate properties.

Inheritance Hierarchy

System.Object
  System.Web.UI.Design.DataBindingHandler
    System.Web.UI.Design.CalendarDataBindingHandler
    System.Web.UI.Design.HyperLinkDataBindingHandler
    System.Web.UI.Design.TextDataBindingHandler
    System.Web.UI.Design.WebControls.ListControlDataBindingHandler
Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
See Also

Reference