aspxtreme

DataGrid.ItemCommand Event

System.Web.UI.WebControls Namespace   DataGrid Class


Occurs when a button within a DataGrid control is clicked.

[ VB ]
Public Event ItemCommand As DataGridCommandEventHandler

[ C# ]
public event DataGridCommandEventHandler ItemCommand;

[ C++ ]
public: __event DataGridCommandEventHandler* ItemCommand;

In [ JScript ], you can handle the events defined by a class, but you cannot define your own.

Remarks

The ItemCommand event is raised whenever any button associated with an item in the DataGrid is clicked. This provides for programmatically determining which specific command button is clicked and take appropriate action. This event is commonly used to handle button controls with a given CommandName value in the DataGrid control.

Event Data

Information related to the ItemCommand event is passed via a DataGridCommandEventArgs object to the method assigned to handle the event. The following DataGridCommandEventArgs properties provide information specific to this event.

Property Description
CommandSource Gets the source of the command.
Item Gets the DataGridItem associated with the event.

Example

The following example illustrates a way to handle the ItemCommand event of a DataGrid. Information about the selected item is displayed whenever any of the LinkButton controls within the DataGrid is clicked.

The below snippet shows how to attach a handler for the event.

<asp:datagrid id = "myDataGrid" runat = "server" onItemCommand = "showItem" ... >

The below shows how the handler method is defined.

void showItem ( Object src, DataGridCommandEventArgs e ) {
   myDataGrid.SelectedIndex = e.Item.ItemIndex;
   string query = "SELECT * FROM nw_Employees";
   myDataGrid.DataSource = fetchData ( query, "northwind" );
   myDataGrid.DataBind ( );
}

 Show me 

See Also

DataGrid Members



Books and more ...


Suggested Reading

Need a break ?



Previous page Back to top Next page

Check out related books at Amazon

© 2000-2008 Rey Nuñez All rights reserved.

If you have any question, comment or suggestion
about this site, please send us a note

You can help support aspxtreme