Main Page

  Previous Section Next Section


System.Web.UI.WebControls (system.web.dll)class

This class extends the Image class to provide an image control that can respond to button clicks. The ImageButton class provides both a Click and a Command event, which will fire when the image is clicked. Use the Command event and the CommandName property to specify additional information that will be provided to the event handler. This technique is sometimes used to allow the same event handler to respond to clicks from multiple ImageButton controls and determine what control fired the event.

By default, clicking an ImageButton control will cause page validation to occur. To change this behavior, set the CausesValidation property to False.

public class ImageButton : Image, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler {
// Public Constructors
   public ImageButton( );
// Public Instance Properties
   public bool CausesValidation{set; get; }
   public string CommandArgument{set; get; }
   public string CommandName{set; get; }
// Protected Instance Properties
   protected override HtmlTextWriterTag TagKey{get; }            // overrides WebControl
// Protected Instance Methods
   protected override void AddAttributesToRender(System.Web.UI.HtmlTextWriter writer);  // overrides Image
   protected virtual void OnClick(System.Web.UI.ImageClickEventArgs e);
   protected virtual void OnCommand(CommandEventArgs e);
   protected override void OnPreRender(EventArgs e);            // overrides System.Web.UI.Control
// Events
   public event ImageClickEventHandler Click;
   public event CommandEventHandler Command;


System.Object System.Web.UI.Control(System.ComponentModel.IComponent, System.IDisposable, System.Web.UI.IParserAccessor, System.Web.UI.IDataBindingsAccessor) WebControl(System.Web.UI.IAttributeAccessor) Image ImageButton(System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler)

      Previous Section Next Section