SharePoint 2010 Training Session 5
Download as PPTX, PDF1 like1,253 views
This document discusses SharePoint 2010 web part development. It covers simple web parts, which can be pure ASP.NET or SharePoint-based. Visual web parts contain a user control. Advance web parts include tool parts or custom editor sections. Tool parts include the default web part tool part, custom property tool parts, and custom tool parts added via code. Custom editor parts are added by implementing the IWebEditable interface and returning an EditorPartCollection.
![SharePoint 2010
Session - 5
By: Usman Zafar Malik
[MCTS: MOSS 2007], [MSCBSS: CRM 3.0 / 4.0], MCP](https://image.slidesharecdn.com/sharepoint2010session5-120228034915-phpapp01/85/SharePoint-2010-Training-Session-5-1-320.jpg)
![Simple Web parts
Define properties in web parts
The WebBrowseable attribute specifies that the decorated property should appear in the editor component
of the web part. It only allows the end user to modify the property and does nothing about persistence.
The Personalizable attribute specifies that the value of the decorated property must be persisted in the
SharePoint backend, either in the user store (by default) or in the shared store (if the Shared scope is
specified). It only cares about persistence and does nothing about the property presence in the editor
component.
So, if you decorate a property with [WebBrowsable] and not [Personalizable], the end user will be able to
modify it in the editor component but its new value won't be persisted.
Conversely, if you decorate a property with [Personalizable] and not [WebBrowsable], its value will be
persisted but the end user won't be allowed to modify it.](https://image.slidesharecdn.com/sharepoint2010session5-120228034915-phpapp01/85/SharePoint-2010-Training-Session-5-12-320.jpg)
![Advance Level Web parts using Toolpart class
public override Microsoft.SharePoint.WebPartPages.ToolPart[] GetToolParts()
{
PersonDetailsToolPart CustomToolPart_ = new PersonDetailsToolPart();
CustomToolPart_.Title = "Company Details";
Microsoft.SharePoint.WebPartPages.ToolPart[] toolParts = new
Microsoft.SharePoint.WebPartPages.ToolPart[3];
toolParts[0] = new Microsoft.SharePoint.WebPartPages.WebPartToolPart();
toolParts[1] = new Microsoft.SharePoint.WebPartPages.CustomPropertyToolPart();
toolParts[2] = CustomToolPart_;
return toolParts;
}
Override the โGetToolParts()โ method in order to add the custom toolpart in to your web part editor
part section.](https://image.slidesharecdn.com/sharepoint2010session5-120228034915-phpapp01/85/SharePoint-2010-Training-Session-5-30-320.jpg)
More Related Content
What's hot (20)
Viewers also liked (7)
Similar to SharePoint 2010 Training Session 5 (20)
More from Usman Zafar Malik (6)
Recently uploaded (20)
SharePoint 2010 Training Session 5
- 1. SharePoint 2010 Session - 5 By: Usman Zafar Malik [MCTS: MOSS 2007], [MSCBSS: CRM 3.0 / 4.0], MCP
- 3. SharePoint 2010 Development โข Simple Web parts โข Advance Level Web parts
- 4. SharePoint 2010 Simple Web parts
- 5. Simple Web parts What are web parts? โข Web Part is also called a Web Widget, is an ASP.NET server control which is added to a Web Part Zone on Web Part Pages by users at run time. It enable end users to modify the content, appearance, and behavior of Web pages directly from a browser. Possible scopes โข Site Level.
- 6. Simple Web parts Two types of web parts โข Pure ASP.Net based web parts Derived from:- System.Web.UI.WebControls.WebParts.WebPart โ Generic web parts, that can be used in SharePoint and outside the SharePoint domain. โข SharePoint based web parts Derived from:- Microsoft.SharePoint.WebPartPages.WebPart โ Only used in the SharePoint domain.
- 7. Simple Web parts Further Categorization in Web parts โข Web parts - A class derived from โWebpartsโ class โข Visual web parts - A class derived from โWebpartsโ but also contains a user control in this web part. - Canโt be used in sandboxed solutions.
- 10. Simple Web parts
- 11. Simple Web parts
- 12. Simple Web parts Define properties in web parts The WebBrowseable attribute specifies that the decorated property should appear in the editor component of the web part. It only allows the end user to modify the property and does nothing about persistence. The Personalizable attribute specifies that the value of the decorated property must be persisted in the SharePoint backend, either in the user store (by default) or in the shared store (if the Shared scope is specified). It only cares about persistence and does nothing about the property presence in the editor component. So, if you decorate a property with [WebBrowsable] and not [Personalizable], the end user will be able to modify it in the editor component but its new value won't be persisted. Conversely, if you decorate a property with [Personalizable] and not [WebBrowsable], its value will be persisted but the end user won't be allowed to modify it.
- 13. Simple Web parts Life Cycle OnInit OnLoad CreateChildControls OnPreRender SaveViewState Site Render RenderContents OnUnload Dispose
- 14. Visual Web parts
- 15. Visual Web parts
- 16. Visual Web parts
- 17. Visual Web parts
- 18. Visual Web parts Life Cycle SimpleVisualWebPart - OnInit SimpleVisualWebPart - OnLoad SimpleVisualWebPart - CreateChildControls SimpleVisualWebPartUserControl - OnInit SimpleVisualWebPartUserControl - OnLoad SimpleVisualWebPartUserControl - Page_Load SimpleVisualWebPart - OnPreRender SimpleVisualWebPartUserControl - OnPreRender SimpleVisualWebPart - SaveViewState SimpleVisualWebPartUserControl - SaveViewState SimpleVisualWebPart - Render SimpleVisualWebPartUserControl - Render
- 19. Visual Web parts Life Cycle SimpleVisualWebPart - RenderContents SimpleVisualWebPartUserControl - OnUnload SimpleVisualWebPartUserControl - Dispose SimpleVisualWebPart - OnUnload SimpleVisualWebPart - Dispose
- 20. SharePoint 2010 Advance Level Web parts
- 21. Advance Level Web parts Advance Level web parts? โข Web part which contains toolpart, or we add some custom controls in Web part Editor Tool part section.
- 22. Advance Level Web parts Advance Level web parts? โข Web part which contains Custom Webpart Editor Section โข Two ways to create Custom Editor Part / Toolpart of Web part โ By inheriting class from โMicrosoft.SharePoint.WebPartPages.ToolPartโ โ By Implementing Interface โIWebEditableโ on Toolpart class
- 23. Advance Level Web parts Using Toolpart class
- 24. Advance Level Web parts Using Toolpart class
- 25. Advance Level Web parts using Toolpart class
- 26. Advance Level Web parts using Toolpart class Three Level of ToolParts โ WebPartToolPart โ CustomPropertyToolPart โ Add Custom ToolPart
- 27. Advance Level Web parts using Toolpart class WebPartToolPart Default WebPart properties:- โข Appearance โ Title โ Width โ Frame State โ Frame Style โข Layout โ Visible on Page โ Direction โ Zone โ Part Order โข Advanced โ Allow Minimize โ Allow Close โ Allow Zone Change โ Allow Export Sensitive Properties โ Detail Link โ Description โ Help Link โ Icon File (Large) โ Icon File (Small) โ Missing Assembly Error โ Target Audiences
- 28. Advance Level Web parts using Toolpart class CustomPropertyToolPart An additional ToolPart that is added when custom properties are added to the WebPart programmatically. Example:- First Name, Last Name
- 29. Advance Level Web parts using Toolpart class CustomToolPart A toolpart which you have programmatically created and want to add in web part editor part. Example:- Derived Classes from โMicrosoft.SharePoint.WebPartPages.ToolPartโ wants to add in the Web partโs Editor section.
- 30. Advance Level Web parts using Toolpart class public override Microsoft.SharePoint.WebPartPages.ToolPart[] GetToolParts() { PersonDetailsToolPart CustomToolPart_ = new PersonDetailsToolPart(); CustomToolPart_.Title = "Company Details"; Microsoft.SharePoint.WebPartPages.ToolPart[] toolParts = new Microsoft.SharePoint.WebPartPages.ToolPart[3]; toolParts[0] = new Microsoft.SharePoint.WebPartPages.WebPartToolPart(); toolParts[1] = new Microsoft.SharePoint.WebPartPages.CustomPropertyToolPart(); toolParts[2] = CustomToolPart_; return toolParts; } Override the โGetToolParts()โ method in order to add the custom toolpart in to your web part editor part section.
- 31. Advance Level Web parts using Toolpart class Common Webpart Properties this.AllowMinimize = true/false this.AllowHide = true/false; this.AllowClose = false; this.ChromeType = PartChromeType.None; (if user wants to remove the border of the web part )
- 32. Advance Level Web parts using IWebEditable Interface Steps - The web part which has the Custom Editor Part must implement the โIWebEditable โinterface. #region IWebEditable Members EditorPartCollection IWebEditable.CreateEditorParts() { // Adding your custom web part editor part (Example:- CustomEditor) List<EditorPart> editors = new List<EditorPart>(); editors.Add(new CustomEditor()); return new EditorPartCollection(editors); } object IWebEditable.WebBrowsableObject { get { return this; } // what is being edited :- Returning the Web part itself. } #endregion
- 33. Advance Level Web parts using IWebEditable Interface Steps - The Custom Editor Webpart must be inherited from โEditorPartโ class. - It must overrides two methods. 1- ApplyChanges Used for copy content from Editor Part to Web part. 2- SyncChanges Used for Copy content from Web part to Editor Part.
- 34. Q&A
- 35. Thanks !