| System.Web.UI.WebControls (system.web.dll) | class |
This class represents a simple command button (also known as a push
button). Button controls always generate a
postback when clicked. As with all button-like server controls, you
can set the CausesValidation property to determine
whether page validation will be performed when the button is clicked,
before the button event handling code is executed. Depending on the
client browser's support for DHTML, an invalid page
may prevent the postback from occurring and the button event handling
code from executing if CausesValidation is
True.
When clicked, a Button raises a
Click event followed by a
Command event. The Command
event passes extra information about the button in a
CommandEventArgs object. This information includes
the CommandName and
CommandArgument properties of the
Button. A typical CommandName
identifies the requested action (like
"Sort").
public class Button : WebControl, System.Web.UI.IPostBackEventHandler {
// Public Constructors
public
Button ( );
// Public Instance Properties
public bool
CausesValidation {set; get; }
public string
CommandArgument {set; get; }
public string
CommandName {set; get; }
public string
Text {set; get; }
// Protected Instance Methods
protected override void
AddAttributesToRender (System.Web.UI.HtmlTextWriter
writer ); // overrides WebControl
protected virtual void
OnClick (EventArgs
e );
protected virtual void
OnCommand (CommandEventArgs
e );
protected override void
RenderContents (System.Web.UI.HtmlTextWriter
writer ); // overrides WebControl
// Events
public event EventHandler
Click ;
public event CommandEventHandler
Command ;
}
Hierarchy
System.Object
System.Web.UI.Control(System.ComponentModel.IComponent,
System.IDisposable,
System.Web.UI.IParserAccessor,
System.Web.UI.IDataBindingsAccessor)
WebControl(System.Web.UI.IAttributeAccessor)
Button(System.Web.UI.IPostBackEventHandler)