System.Web.UI.WebControls Namespace   Button Class

Sets or retrieves the command name associated with the Button control that is passed to the Command event.

The property is read/write with no default value.

Use the CommandName property to specify or determine the command associated with the Button controls. This is particularly useful when a Web Forms page include multiple Button controls.

You can set the CommandName property to any valid string that identifies the command to perform when a button is clicked. You can then programmatically determine the command name of the Button control and handle the command appropriately.

You can also optionally pass additional information about the command by using the CommandArgument property.

The following example demonstrates how to use the CommandName property to create a Button control that sorts a list in ascending order.

<form runat = "server">

   <asp:button id = "myButton" runat = "server" text = "Sort"
      commandname = "Sort"
      commandargument = "Ascending"
      onCommand = "getCommandArgs " />

</form>

The below example demontrates a Command event handler that, in this case, simply determines the event arguments passed to the handler when a Button is clicked.

void getCommandArgs ( Object src, CommandEventArgs e ) {
   // insert code to sort in ascending order here.
   msg.Text = "You clicked the " + e.CommandName +
      " - " + e.CommandArgument + " button.";
}

Sub getCommandArgs ( src As Object, e As CommandEventArgs )
   ' insert code to sort in ascending order here.
   msg.Text = "You clicked the " & e.CommandName & _
      " - " & e.CommandArgument & " button."
End Sub

Button Members   Command Event