ImageButton.CommandName Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the command name associated with the ImageButton control.
public:
property System::String ^ CommandName { System::String ^ get(); void set(System::String ^ value); };
public string CommandName { get; set; }
[System.Web.UI.Themeable(false)]
public string CommandName { get; set; }
member this.CommandName : string with get, set
[<System.Web.UI.Themeable(false)>]
member this.CommandName : string with get, set
Public Property CommandName As String
Property Value
The command name associated with the ImageButton control. The default value is Empty.
Implements
- Attributes
Examples
The following example demonstrates how to use the CommandName property to associate a command name with an ImageButton control.
Note
The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.
<%@ 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>ImageButton CommandName Sample</title>
<script language="C#" runat="server">
void ImageButton_Command(object sender, CommandEventArgs e)
{
if (e.CommandName == "Sort")
Label1.Text = "You clicked the Sort Button";
else
Label1.Text = "You clicked the Edit Button";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageButton CommandName Sample</h3>
Click an image.<br /><br />
<asp:ImageButton id="imagebutton1" runat="server"
AlternateText="Sort"
ImageUrl="images/pict1.jpg"
OnCommand="ImageButton_Command"
CommandName="Sort"/>
<asp:ImageButton id="imagebutton2" runat="server"
AlternateText="Edit"
ImageUrl="images/pict2.jpg"
OnCommand="ImageButton_Command"
CommandName="Edit"/>
<br /><br />
<asp:label id="Label1" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" 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>ImageButton CommandName Sample</title>
<script language="VB" runat="server">
Sub ImageButton_Command(sender As Object, e As CommandEventArgs)
If e.CommandName = "Sort" Then
Label1.Text = "You clicked the Sort Button"
Else
Label1.Text = "You clicked the Edit Button"
End If
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageButton CommandName Sample</h3>
Click an image.<br /><br />
<asp:ImageButton id="imagebutton1" runat="server"
AlternateText="Sort"
ImageUrl="images/pict1.jpg"
OnCommand="ImageButton_Command"
CommandName="Sort"/>
<asp:ImageButton id="imagebutton2" runat="server"
AlternateText="Edit"
ImageUrl="images/pict2.jpg"
OnCommand="ImageButton_Command"
CommandName="Edit"/>
<br /><br />
<asp:label id="Label1" runat="server"/>
</form>
</body>
</html>
Remarks
Use this property to specify the command to perform when the ImageButton control is clicked, such as Sort
, Cancel
, or Edit
. This allows multiple ImageButton controls to be placed on the same Web page. The value in this property can then be programmatically identified in the OnCommand event handler to determine the appropriate action to perform when each ImageButton control is clicked.
Supplemental information about the command, such as specifying ascending sort order, can be included by using the CommandArgument property.
This property cannot be set by themes or style sheet themes. For more information, see ThemeableAttribute and ASP.NET Themes and Skins.