ButtonSection.ascx Control

When developing application pages, you can use this control to place a button section on the page. In this button section you can place one or more buttons that execute the actions to take.

 

  To include a ButtonSection control on an application page you have to use the following syntax:

<wssuc:ButtonSection runat="server" ShowStandardCancelButton="true">
    <template_buttons>
       <asp:PlaceHolder runat="server">               
           <asp:Button id="SubmitButton" UseSubmitBehavior="false" runat="server" class="ms-ButtonHeightWidth" 
                       Text="OK" OnClick="SubmitButton_Click" />
       </asp:PlaceHolder>
    </template_buttons>
</wssuc:ButtonSection>

Add also a directive at the top of the page:

<%@ Register TagPrefix="wssuc" TagName="ButtonSection" Src="/_controltemplates/ButtonSection.ascx" %>

Code for the OnClick event of the individual buttons needs to be written within a <script runat=”server” language=”C#”> tag on the application page or in the code behind class from which the application page inherits:

 protected Button SubmitButton;        
 public void SubmitButton_Click(object sender, System.EventArgs e)
 {
     // TODO: must save the changes proposed on the page
 }

There are also a number of attributes you can set on the ButtonSection control:

•  ShowStandardCancelButton: if you set this property to true, a Cancel button is automatically added to the ButtonSection control. This cancel button will redirect the user to the previous page in the browser history.
• ShowSectionLine: set this property to false if you don’t want a section line to be added above the buttons. The default value is true.
• BottomSpacing: in case of long pages it is possible you want to add a button section at the top of the page and one at the bottom of the page. If you put a button section at the top of the page, you can set this property to a value higher than zero to add extra blank spacing between the button section and the controls that follow.
• SmallSectionLine: if you set this boolean value to true, the section line will be 1px high; if set to false, the section line will be 2px high. The default is false.