GridView::OnRowCreated Method
Updated: August 2008
Raises the RowCreated event.
Assembly: System.Web (in System.Web.dll)
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 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.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, 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.