LinkButton.Command Event
Occurs when the Button control is clicked.
[Visual Basic] Public Event Command As CommandEventHandler [C#] public event CommandEventHandler Command; [C++] public: __event CommandEventHandler* Command;
[JScript] In JScript, you can handle the events defined by a class, but you cannot define your own.
Event Data
The event handler receives an argument of type CommandEventArgs containing data related to this event. The following CommandEventArgs properties provide information specific to this event.
| Property | Description |
|---|---|
| CommandArgument | Gets the argument for the command. |
| CommandName | Gets the name of the command. |
Remarks
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.
For more information about handling events, see Consuming Events.
Example
[Visual Basic, C#, JScript] The following example demonstrates how to specify and code a handle for the Click event to display a message when the LinkButton control is clicked.
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script language="VB" runat="server"> Sub LinkButton_Command(sender As Object, e As CommandEventArgs) Label1.Text = "You chose: " & e.CommandName & " Item " & _ e.CommandArgument End Sub </script> </head> <body> <form 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> <p> <asp:Label id="Label1" runat="server"/> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <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 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> <p> <asp:Label id="Label1" runat="server"/> </form> </body> </html> [JScript] <%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> <script language="JSCRIPT" runat="server"> function LinkButton_Command(sender : Object, e : CommandEventArgs){ Label1.Text = "You chose: " + e.CommandName + " Item " + e.CommandArgument } </script> </head> <body> <form 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> <p> <asp:Label id="Label1" runat="server"/> </form> </body> </html>
[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
LinkButton Class | LinkButton Members | System.Web.UI.WebControls Namespace | OnCommand | CommandEventHandler