GridView.RowCreated Event

Note: This event is new in the .NET Framework version 2.0.

Occurs when a row is created in a GridView control.

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

event GridViewRowEventHandler^ RowCreated {
	void add (GridViewRowEventHandler^ value);
	void remove (GridViewRowEventHandler^ value);
/** @event */
public void add_RowCreated (GridViewRowEventHandler value)

/** @event */
public void remove_RowCreated (GridViewRowEventHandler value)

JScript supports the use of events, but not the declaration of new ones.

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 allows you to provide an event-handling method that performs a custom routine, such as adding custom content to a row, whenever this event occurs.

A GridViewRowEventArgs object is passed to the event-handling method, which allows you to access the properties of the row being created. To access a specific cell in the row, use the Cells property of the GridViewRowEventArgs object. You can determine which row type (header row, data row, and so on) is being created by using the RowType property.

For more information about handling events, see Consuming Events.

The following code example demonstrates how to use the RowCreated event to store the index of the row being created in the CommandArgument property of a LinkButton control contained in the row. This allows you to determine the index of the row that contains the LinkButton control when the user clicked the button.

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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0