Creating Web Parts for SharePoint
By using Web parts, users can directly modify the content, appearance, and behavior of SharePoint site pages by using a browser. Web parts are server-side controls that run inside a special type of page called a web part page: they are the building blocks of pages that appear on a SharePoint site. For more information about web parts in SharePoint, see Building Block: Web Parts.
Visual Studio provides templates that you can use to create and debug web parts on a SharePoint site.
Creating a Web Part in Visual Studio
Create a web part by adding a Web Part item to any SharePoint project. You can use a Web Part item in a sandboxed solution or a farm solution.
If you want to design a web part visually by using a designer, create a Visual Web Part project or add Visual Web Part item to any SharePoint project. You can use a Visual Web Part item in a farm solution only.
Web Part Item
A Web Part item provides files that you can use to design a web part for a SharePoint site. When you add a Web Part item, Visual Studio creates a folder in your project and then adds several files to the folder. The following table describes each file.
File |
Description |
|---|---|
Elements.xml |
Contains information that the Feature definition file in your project uses to deploy the web part. |
.webpart file |
Provides information that SharePoint needs to display your web part in a web part gallery. |
Code File |
Contains methods that add controls to the web part and that generate custom content within the web part. |
For more information, see How to: Create a SharePoint Web Part.
Visual Web Part Item
A visual web part is a web part that you create by using the Visual Web Developer designer in Visual Studio. For more information about how to use this designer, see Visual Studio Web Development Environment Content Map.
Functionally, a visual web part is no different from a web part. A Visual Web Part item includes a Web Part item and a User Control item.
You can design the appearance of the web part by dragging or copying controls from the Visual Studio Toolbox to the surface of the user control. For more information, see How to: Create a SharePoint Web Part by Using a Designer.
SharePoint Controls
Visual Studio provides some controls for creating SharePoint pages, such as application pages. These controls appear in the toolbox under SharePoint Controls. The functionality for these controls derives from the Microsoft.SharePoint.WebControls namespace, which contains ASP.NET server controls that are used on SharePoint site and list pages.
Control Name |
Description |
|---|---|
Inserts an ASP menu. For more information, see Menu Control Overview. |
|
Inserts a LINK element into the .aspx page and applies one or more external style sheets defined by CssRegistration. |
|
Inserts a DateTime control into the .aspx page. |
|
Inserts a security validation into the .aspx page |
|
Returns a property of a specified list. |
|
Returns a global property of the current website. |
|
Inserts a link to an RSS feed into the .aspx page. |
|
Provides properties and methods for registering resources, such as scripts, on a page so that they can be requested when the page is rendered. |
|
Applies a theme to the .aspx page. |
Debugging a Web Part
You can debug a SharePoint project that contains a web part just as you would debug other Visual Studio projects. When you start the Visual Studio debugger, Visual Studio opens the SharePoint site.
To start to debug your code, add the web part to a web part page in SharePoint.
For more information about how to debug SharePoint projects, see Troubleshooting SharePoint Solutions.
Visual Web Part Limitations
Starting in Visual Studio, you can add visual web parts to sandboxed SharePoint solutions and farm solutions. However, visual web parts have the following limitations:
Visual web parts don't support replaceable parameters. For more information, see Replaceable Parameters.
User controls or visual web parts can't be dragged and dropped or copied onto visual web parts. This action causes a build error.
Visual web parts don't directly support SharePoint server tokens such as $SPUrl. For more information, see "Token Restrictions in Sandboxed Visual Web Parts" in the topic Troubleshooting SharePoint Solutions.
Visual web parts in a sandboxed solution occasionally get the error, "The sandboxed code execution request was refused because the Sandboxed Code Host Service was too busy to handle the request." For more information about this error, see this post in the SharePoint Developer Team Blog.
Server-side JavaScript debugging isn't supported in Visual Studio, but client-side JavaScript debugging is supported.
Although you can add inline JavaScript to a server-side markup file, debugging isn't supported for breakpoints added to the markup. To debug JavaScript, reference an external JavaScript file in the markup file, and then set the breakpoints in the JavaScript file.
Debugging of inline ASP.NET code must be done in the generated code file instead of in the markup file.
Visual web parts don't support the use of the <@ Assembly Src= directive.
SharePoint web controls and some ASP.NET controls aren't supported in the SharePoint sandboxed environment. If unsupported controls are used on a visual web part in a sandboxed solution, the error, "The type or namespace name 'Theme' does not exist in the namespace 'Microsoft.SharePoint.WebControls'" appears.
For more information about sandboxed solutions, see Differences Between Sandboxed and Farm Solutions.
Creating Older Style SharePoint-Based Web Parts
You can use the templates in Visual Studio to create custom ASP.NET 2.0 web parts for SharePoint. ASP.NET 2.0 web parts are built on top of the ASP.NET web part infrastructure and are the recommended type for new projects.
In very few cases, you might have to create a web part by using the older style SharePoint-based web part. You can use Visual Studio to create these types of web parts, but Visual Studio doesn't provide any templates that are designed specifically to help you create them.
For more information about when you might want to create an older style SharePoint-based web part, see Web Part Infrastructure in Windows SharePoint Services. For more information about how to create a web part by using the older style SharePoint-based web part, see Walkthrough Creating a Basic SharePoint Web Part.
Related Topics
Title |
Description |
|---|---|
Shows you how to create web parts for SharePoint pages. |
|
Shows you how to create web parts for SharePoint by using a visual design surface. |
|
How to: Create a User Control for a SharePoint Application Page or Web Part |
Shows you how to create custom, reusable controls that can be consumed by application pages and web parts that run in SharePoint. |
Describes how to design a web part for SharePoint. |
|
Walkthrough: Creating a Web Part for SharePoint by Using a Designer |
Describes how to design a web part for SharePoint by dragging controls to a visual design surface. |
Walkthrough: Creating a Silverlight Web Part that Displays OData for SharePoint |
Describes how to design a web part for SharePoint that hosts a Silverlight application and displays data from SharePoint lists. |
Describes how to use the designer that appears when you open a webpage in your project. |