<%@ Page Language="C#" MasterPageFile="~/aspnet/section.master" %> <%@ Register TagPrefix=Acme Namespace=Acme %> <%@ Register TagPrefix="Acme" TagName="SourceRef" Src="~/util/SrcRef.ascx"%>

Button

The Button control provides a command button-style control that is used to post a Web Forms page back to the server. The following sample illustrates using a simple Button control.

Bubbling Button Clicks Within a List

When used in a templated list such as a Repeater or DataList, many Button controls might be rendered as the list iterates over its data source. Because each of these Button controls shares the same ID, you cannot simply bind an event handler to each Button control's OnClick event to determine the particular Button that was clicked. To solve this, you use event bubbling to fire an event on the container control (in this case, the Repeater, DataList, or DataGrid), and let the container impart additional information to the event handler about the item that raised the event.

These events can be raised from a Button by specifying a CommandName property with the name of the event. When the Button is clicked, the command "bubbles" to the container control (such as Repeater), which fires its own event. The arguments for this event might contain additional information, such as a custom string or the index of the item that raised the event.

The following sample illustrates how a Button control's commands can bubble to the OnItemCommand event of a list. The Button control's CommandName and CommandArgument strings are passed to the OnItemCommand event, permitting the sample code to distinguish which button was clicked.

Mouse-Over Effects on Button

You can hook the client script events onmouseover and onmouseout on a Button control to provide mouse-over effects such as changing the font or color of the button. Client attributes such as onmouseover are disregarded by ASP.NET on the server, and passed "as is" to the browser. If your application targets newer browsers that support DHTML, these events will fire in the browser as the cursor passes over the button. The following sample demonstrates buttons with mouse-over effects.