GridView::OnRowCreated Method (GridViewRowEventArgs^)

 

Raises the RowCreated event.

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

protected:
virtual void OnRowCreated(
	GridViewRowEventArgs^ e
)

Parameters

e
Type: System.Web.UI.WebControls::GridViewRowEventArgs^

A GridViewRowEventArgs that contains event data.

Before the GridView control can be rendered, a GridViewRow object must be created for each row in the control. The RowCreated event is raised when each row in the GridView control is created. This enables you to provide an event-handling method that performs a custom routine, such as adding custom content to a row, whenever this event occurs.

Raising an event invokes the event handler through a delegate. For more information, see NIB: Raising an Event.

The OnRowCreated 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.

Notes to Inheritors:

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

The following example demonstrates how provide an event-handling method for the RowCreated event. When a row is being created, its index is stored in the CommandArgument property of a LinkButton control that is contained in the new row. This enables you to determine the index of the row when the user clicks the command button.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: