ImageButton.CommandName Property

Gets or sets the command name associated with the ImageButton control.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

[ThemeableAttribute(false)] 
public:
virtual property String^ CommandName {
	String^ get () sealed;
	void set (String^ value) sealed;
}
/** @property */
public final String get_CommandName ()

/** @property */
public final void set_CommandName (String value)

public final function get CommandName () : String

public final function set CommandName (value : String)

Property Value

The command name associated with the ImageButton control. The default value is String.Empty.

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 Overview.

The following example demonstrates how to use the CommandName property to associate a command name with an ImageButton control.

NoteNote

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 Page Code Model.

No code example is currently available or this language may not be supported.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show: