LinkButton.OnCommand Method (CommandEventArgs)
Raises the Command event of the LinkButton control.
Assembly: System.Web (in System.Web.dll)
Parameters
- e
-
Type:
System.Web.UI.WebControls.CommandEventArgs
A CommandEventArgs that contains the event data.
The Command event is raised when the LinkButton control is clicked. This event is commonly used when a command name, such as Sort, is associated with the LinkButton control. This allows you to create multiple LinkButton controls on a Web page and programmatically determine which LinkButton control is clicked.
Note |
|---|
The Command event is raised through the control hierarchy in the form of the BubbleEvent. |
Raising an event invokes the event handler through a delegate. For more information, see NIB: Raising an Event.
The OnCommand 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 OnCommand in a derived class, be sure to call the base class's OnCommand method so that registered delegates receive the event.
The following example demonstrates how to specify and code a handler for the Command event to display which LinkButton control is clicked.
<%@ Page Language="C#" AutoEventWireup="True" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>LinkButton Command Event Example</title> <script language="C#" runat="server"> void LinkButton_Command(Object sender, CommandEventArgs e) { Label1.Text = "You chose: " + e.CommandName + " Item " + e.CommandArgument; } </script> </head> <body> <form id="form1" runat="server"> <h3>LinkButton Command Event Example</h3> <asp:LinkButton id="LinkButton1" Text="Order Item 10001" CommandName="Order" CommandArgument="10001" OnCommand="LinkButton_Command" runat="server"/> <br /> <asp:LinkButton id="LinkButton2" Text="Order Item 10002" CommandName="Order" CommandArgument="10002" OnCommand="LinkButton_Command" Runat="server"/> <br /> <br /> <asp:Label id="Label1" runat="server"/> </form> </body> </html>
Available since 1.1
