OnRowCreated Method
Collapse the table of content
Expand the table of content

GridView::OnRowCreated Method

Raises the RowCreated event.

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

virtual void OnRowCreated(
	GridViewRowEventArgs^ 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 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

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

© 2015 Microsoft