ASP.NET.in.a.Nutshell.Second.Edition [Electronic resources] نسخه متنی

The Command control renders as a command button or
a link, depending on the device. Though the style differs depending
on the device, the Text will always appear. The
Command control plays the same role as the
System.Web.UI.WebControls.Button on a full-blown
web page, triggering a postback when selected and raising a
server-side Click event. In addition, the
ItemCommand will fire with additional information
about the command in a
System.Web.UI.WebControls.CommandEventArgs object.
This information includes the
System.Web.UI.WebControls.Button.CommandName and
System.Web.UI.WebControls.Button.CommandArgument
properties of the
System.Web.UI.WebControls.Button. The
ItemCommand event is useful when you are creating
composite or data-bound controls that include buttons, because the
event will is bubbled up to parent controls. If you do not need this
functionality, you can simply handle the Click
event. If the mobile device supports softkeys, you can set the label
that will be used for the corresponding softkey through the
SoftkeyLabel property. Otherwise, the
Text property will be used for the label if it
less than nine characters (or the label
"Go" will be displayed if it is
not).

You can set the CausesValidation property to
determine whether page validation will be performed when the command
is selected, before the Click or
ItemCommand events fire.

public class 
Command  : TextControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.IPostBackDataHandler {
// Public Constructors
public 
Command ( );
// Public Instance Properties
public bool 
CausesValidation {set; get; }
public string 
CommandArgument {set; get; }
public string 
CommandName {set; get; }
public CommandFormat 
Format {set; get; }
public string 
ImageUrl {set; get; }
public string 
SoftkeyLabel {set; get; }
// Protected Instance Methods
protected override bool 
IsFormSubmitControl ( );                // overrides MobileControl
protected virtual void 
OnClick (EventArgs 
e );
protected virtual void 
OnItemCommand (System.Web.UI.WebControls.CommandEventArgs 
e )
protected override void 
OnPreRender (EventArgs 
e );            // overrides MobileControl
// Events
public event EventHandler 
Click ;
public event CommandEventHandler 
ItemCommand ;
}

Hierarchy

System.Object
System.Web.UI.Control(System.ComponentModel.IComponent,
System.IDisposable,
System.Web.UI.IParserAccessor,
System.Web.UI.IDataBindingsAccessor)

MobileControl(System.Web.UI.IAttributeAccessor)
TextControl
Command(System.Web.UI.IPostBackEventHandler,
System.Web.UI.IPostBackDataHandler)

Returned By

System.Web.UI.MobileControls.Adapters.HtmlCommandAdapter.Control,
System.Web.UI.MobileControls.Adapters.WmlCommandAdapter.Control