DataBindingHandlerAttribute Class

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Specifies a design-time class that performs data binding of controls within a designer. This class cannot be inherited.

public ref class DataBindingHandlerAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class DataBindingHandlerAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type DataBindingHandlerAttribute = class
    inherit Attribute

Public NotInheritable Class DataBindingHandlerAttribute
Inherits Attribute

Inheritance

Object

Attribute

DataBindingHandlerAttribute

Attributes

AttributeUsageAttribute

Examples

The following code example defines a data-binding handler, named MyDataBindingHandler, to be used by the designer in editing mode. On exiting the editing mode, the Text property value is displayed.

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

namespace CustomControls
{
  [
    DataBindingHandler(typeof(MyDataBindingHandler)),
    ToolboxData("<{0}:MyLabel runat=server></{0}:MyLabel>")
  ]
  public class MyLabel : Label 
  {
    public  MyLabel()
    { 
      // Insert your code here.
    } 
  }

  public class MyDataBindingHandler : DataBindingHandler
  {
    public override void DataBindControl(IDesignerHost host, Control control)
    {
      ((Label)control).Text = "Added by data binding handler.";
    }
  }
}

Namespace CustomControls

  <DataBindingHandler(GetType(MyDataBindingHandler)), ToolboxData("<{0}:MyLabel runat=server></{0}:MyLabel>")>  _
    Public Class MyLabel
      Inherits Label
      
      Public Sub New()
        'Insert your code here.
      End Sub
      
    End Class
   
    Public Class MyDataBindingHandler
      Inherits DataBindingHandler
      
      Public Overrides Sub DataBindControl(host As IDesignerHost, control As Control)
         CType(control, Label).Text = "Added by data binding handler."
      End Sub
      
    End Class
    
End Namespace 'CustomControls

Remarks

For more information about using attributes, see Attributes.

Constructors

DataBindingHandlerAttribute()	Initializes a new instance of the DataBindingHandlerAttribute class using no parameters. This is the parameterless constructor.
DataBindingHandlerAttribute(String)	Initializes a new instance of the DataBindingHandlerAttribute class with the specified type name.
DataBindingHandlerAttribute(Type)	Initializes a new instance of the DataBindingHandlerAttribute class of the specified Type.

Fields

Default

Defines the default attribute for the DataBindingHandlerAttribute class.

Properties

HandlerTypeName	Gets the type name of the data-binding handler.
TypeId	When implemented in a derived class, gets a unique identifier for this Attribute. (Inherited from Attribute)

Methods

Equals(Object)	Determines whether two object instances are equal.
GetHashCode()	Returns the hash code for this instance.
GetType()	Gets the Type of the current instance. (Inherited from Object)
IsDefaultAttribute()	When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class. (Inherited from Attribute)
Match(Object)	When overridden in a derived class, returns a value that indicates whether this instance equals a specified object. (Inherited from Attribute)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Explicit Interface Implementations

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Maps a set of names to a corresponding set of dispatch identifiers. (Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Retrieves the type information for an object, which can be used to get the type information for an interface. (Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Provides access to properties and methods exposed by an object. (Inherited from Attribute)

See also

• Attribute