Edit

Share via


Control.DataBinding Event

Definition

Occurs when the server control binds to a data source.

C#
public event EventHandler DataBinding;

Event Type

Examples

C#
/* Create a class that implements the ITemplate interface.
   This class overrides the InstantiateIn method to always
   place templates in a Literal object. It also creates a 
   custom BindData method that is used as the event handler
   associated with the Literal object's DataBinding event.  
*/
  
using System;
using System.Web;
using System.Data;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace UsingItemTemplates
{
    public class GenericItem : ITemplate
    {
        private string column;
      
        public GenericItem(string column)
        {
            this.column = column;
        }

        // 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();
        }
    }
}

Remarks

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

Applies to

Product Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

See also