GridView.OnRowDataBound(GridViewRowEventArgs) Method

Definition

Raises the RowDataBound event.

protected:
 virtual void OnRowDataBound(System::Web::UI::WebControls::GridViewRowEventArgs ^ e);
protected virtual void OnRowDataBound (System.Web.UI.WebControls.GridViewRowEventArgs e);
abstract member OnRowDataBound : System.Web.UI.WebControls.GridViewRowEventArgs -> unit
override this.OnRowDataBound : System.Web.UI.WebControls.GridViewRowEventArgs -> unit
Protected Overridable Sub OnRowDataBound (e As GridViewRowEventArgs)

Parameters

e
GridViewRowEventArgs

A GridViewRowEventArgs that contains event data.

Remarks

Before the GridView control can be rendered, each row in the control must be bound to a record in the data source. The RowDataBound event is raised when a data row (represented by a GridViewRow object) is bound to data in the GridView control. This enables you to provide an event-handling method that performs a custom routine, such as modifying the values of the data bound to the row, whenever this event occurs.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

The OnRowDataBound method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

A Visual Studio Web site project with source code is available to accompany this topic: Download.

Notes to Inheritors

When overriding OnRowDataBound(GridViewRowEventArgs) in a derived class, be sure to call the base class's OnRowDataBound(GridViewRowEventArgs) method so that registered delegates receive the event.

Applies to

See also