Control.DataBinding Event (System.Web.UI)

DataBinding Event

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Control..::.DataBinding Event

Updated: November 2007

Occurs when the server control binds to a data source.

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

Syntax

Visual Basic (Declaration)

Public Event DataBinding As EventHandler

Visual Basic (Usage)

Dim instance As Control
Dim handler As EventHandler

AddHandler instance.DataBinding, handler

public event EventHandler DataBinding

Visual C++

public:
 event EventHandler^ DataBinding {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

/** @event */
public void add_DataBinding (EventHandler value)
/** @event */
public void remove_DataBinding (EventHandler value)

JScript

JScript does not support events.

Remarks

This event notifies the server control to perform any data-binding logic that has been written for it.

Topic	Location
How to: Create Event Handlers in ASP.NET Web Pages	Building ASP .NET Web Applications
How to: Create Event Handlers in ASP.NET Web Pages	Building ASP .NET Web Applications
How to: Create Event Handlers in ASP.NET Web Pages	Building ASP .NET Web Applications

Examples

Visual Basic

' Override the ITemplate.InstantiateIn method to ensure 
' that the templates are created in a Literal control and
' that the Literal object's DataBinding event is associated
' with the BindData method.
Public Sub InstantiateIn(container As Control) Implements ITemplate.InstantiateIn
   Dim l As New Literal()
   AddHandler l.DataBinding, AddressOf Me.BindData
   container.Controls.Add(l)
End Sub 'InstantiateIn

' Create a public method that will handle the
' DataBinding event called in the InstantiateIn method.
Public Sub BindData(sender As Object, e As EventArgs)
   Dim l As Literal = CType(sender, Literal)
   Dim container As DataGridItem = CType(l.NamingContainer, DataGridItem)
   l.Text = CType(container.DataItem, DataRowView)(column).ToString()
End Sub 'BindData

// Override the ITemplate.InstantiateIn method to ensure 
// that the templates are created in a Literal control and
// that the Literal object's DataBinding event is associated
// with the BindData method.
public void InstantiateIn(Control container)
{
    Literal l = new Literal();
    l.DataBinding += new EventHandler(this.BindData);
    container.Controls.Add(l);
}
// Create a public method that will handle the
// DataBinding event called in the InstantiateIn method.
public void BindData(object sender, EventArgs e)
{
    Literal l = (Literal) sender;
    DataGridItem container = (DataGridItem) l.NamingContainer;
    l.Text = ((DataRowView) container.DataItem)[column].ToString();

}

// Override the ITemplate.InstantiateIn method to ensure 
// that the templates are created in a Literal control and
// that the Literal object's DataBinding event is associated
// with the BindData method.
public void InstantiateIn(Control container)
{
    Literal l = new Literal();
    l.add_DataBinding(new EventHandler(this.BindData));
    container.get_Controls().Add(l);
} //InstantiateIn

// Create a public method that will handle the
// DataBinding event called in the InstantiateIn method.
public void BindData(Object sender, EventArgs e)
{
    Literal l = (Literal)sender;
    DataGridItem container = (DataGridItem)l.get_NamingContainer();
    l.set_Text(((DataRowView)container.get_DataItem()).
        get_Item(column).ToString());
} //BindData

Platforms

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, 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