DataBindingHandlerAttribute Constructors

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Initializes a new instance of the DataBindingHandlerAttribute class.

Overloads

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.

DataBindingHandlerAttribute()

Initializes a new instance of the DataBindingHandlerAttribute class using no parameters. This is the parameterless constructor.

public:
 DataBindingHandlerAttribute();

public DataBindingHandlerAttribute ();

Public Sub New ()

Examples

The following code example uses the DataBindingHandlerAttribute constructor.

// The following example uses the Default
// DataBindingHandlerAttribute constructor.
using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Security.Permissions;

namespace MyTextCustomControl
{
   [ DataBindingHandlerAttribute() ]
   [AspNetHostingPermission(SecurityAction.Demand, 
      Level=AspNetHostingPermissionLevel.Minimal)]
   public sealed class MyTextBox : TextBox
   {
      protected override void Render(HtmlTextWriter output)
      {
         output.Write("This class uses the DataBindingHandlerAttribute class.");
      }
   }
}

' The following example uses the Default
' DataBindingHandlerAttribute constructor.
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions

Namespace MyTextCustomControl

 <DataBindingHandlerAttribute()>  _
 <AspNetHostingPermission(SecurityAction.Demand, _
   Level:=AspNetHostingPermissionLevel.Minimal)> _
 Public NotInheritable Class MyTextBox
   Inherits TextBox
   
   Protected Overrides Sub Render(output As HtmlTextWriter)
      output.Write("This class uses the DataBindingHandlerAttribute class.")
   End Sub

 End Class
End Namespace 'MyTextCustomControl

DataBindingHandlerAttribute(String)

Initializes a new instance of the DataBindingHandlerAttribute class with the specified type name.

public:
 DataBindingHandlerAttribute(System::String ^ typeName);

public DataBindingHandlerAttribute (string typeName);

new System.Web.UI.DataBindingHandlerAttribute : string -> System.Web.UI.DataBindingHandlerAttribute

Public Sub New (typeName As String)

Parameters

typeName

String

The fully qualified name of the data-binding handler Type.

Examples

The following code example uses the DataBindingHandlerAttribute constructor to designate a custom DataBindingHandler class for the Web control.

// The following example uses the 
// DataBindingHandlerAttribute(String) constructor to designate
// the custom DataBindingHandler class, named MyDataBindingHandler,
// for the custom MyWebControl class.
using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.Design;
using System.ComponentModel.Design;
using System.Security.Permissions;

namespace MyTextCustomControl
{
   [ DataBindingHandlerAttribute("MyTextCustomControl.MyDataBindingHandler") ]
   [AspNetHostingPermission(SecurityAction.Demand, 
      Level=AspNetHostingPermissionLevel.Minimal)]
   public sealed class MyWebControl : WebControl
   {
      protected override void Render(HtmlTextWriter output)
      {
         output.Write("This class uses the DataBindingHandlerAttribute class.");
      }
   }

   public class MyDataBindingHandler : TextDataBindingHandler
   {
      public override void DataBindControl(IDesignerHost host, Control myControl)
      {
         ((TextBox)myControl).Text = "Added by MyDataBindingHandler";
      }
   }
}

' The following example uses the 
' DataBindingHandlerAttribute(String) constructor to designate
' the custom DataBindingHandler class, named MyDataBindingHandler,
' for the custom MyWebControl class.
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design
Imports System.ComponentModel.Design
Imports System.Security.Permissions

Namespace MyTextCustomControl

 <DataBindingHandlerAttribute("MyTextCustomControl.MyDataBindingHandler")>  _
 <AspNetHostingPermission(SecurityAction.Demand, _
   Level:=AspNetHostingPermissionLevel.Minimal)> _
 Public NotInheritable Class MyWebControl
   Inherits WebControl
   
   Protected Overrides Sub Render(output As HtmlTextWriter)
      output.Write("This class uses the DataBindingHandlerAttribute class.")
   End Sub
 End Class


 Public Class MyDataBindingHandler
   Inherits TextDataBindingHandler
   
   Public Overrides Sub DataBindControl(host As IDesignerHost, myControl As Control)
      CType(myControl, TextBox).Text = "Added by MyDataBindingHandler"
   End Sub
 End Class
End Namespace 'MyTextCustomControl

Remarks

The type name for this constructor is the fully qualified name of the type, including its assembly name.

DataBindingHandlerAttribute(Type)

Initializes a new instance of the DataBindingHandlerAttribute class of the specified Type.

public:
 DataBindingHandlerAttribute(Type ^ type);

public DataBindingHandlerAttribute (Type type);

new System.Web.UI.DataBindingHandlerAttribute : Type -> System.Web.UI.DataBindingHandlerAttribute

Public Sub New (type As Type)

Parameters

type

Type

The Type for the data-binding handler.

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

The syntax for this attribute is:

[DataBindingHandlerAttribute  
  (typeof(dataBindingHandlerType))]