Thursday, January 23, 2014

Create SharePoint Buttons on Administration Page

A long time ago I wrote a SharePoint administration page and had used the "Microsoft.SharePoint.Portal.WebControls" dll to create Ok and Cancel buttons at the bottom of the page.  Well I recently had a customer who wanted to use it but only had WSS and the page was erroring out when they tried to load it instead I ended up using another solution from Karine Bosch which is below.

Link to original article: http://karinebosch.wordpress.com/sharepoint-controls/buttonsectionascx-control/

 

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.