SharePoint开发学习笔记3——Visual Web Part及自定义配置界面
Visual Web Part
我们在使用VS2010新建SharePoint项目的时候，我们可以看到一个Visual Web Part工程模板（如图）。
以前在SharePoint中实现一个Web Part一般都是使用类工程，几乎所有的表现样式和控件等都是通过手写代码来实现的，要不就是借用第三方的用户控件包装器去实现，而且调试运行也相对麻烦。
现在VS2010提供的这个模板直接使用用户控件来进行Web Part的设计，可以像做普通网页一样对它进行开发，而且调试运行的时候，VS2010也会临时的自动将它部署在你选择的站点里进行运行，调试也变得相当方便了。
首先，你要创建一个Visual Web Part项目需要你在计算机管理员的权限下运行VS2010才行，当然，如果不是的话，VS2010也会对你警告的。
下一步我们正式开始创建一个新的Visual Web Part工程。当你点击点击创建按钮后，VS2010会弹出一个窗口，让你选择在哪个本地站点中进行调试（如图）。
填写一个你自己的SharePoint站点即可，然后点击完成之后，你的项目就创建成功了。VS2010也会在项目创建成功后立即转向到用户控件上。然后我们点开设计视图，就可以直接拖服务端或者Html控件上来了，此外，还可以直接在此加载JQuery这些JS库进来（如图）。
完成的功能很简单，就是输入你的名字，点击按钮后，下排的文字就显示欢迎你的文字。
我们直接点调试运行，就会自动弹出我们之前选择部署的站点，输入用户名和密码后进入，点击站点设置，选择编辑页面。（如图）
然后在页面上再点击添加Web Part，在Custom目录下找到之前我们创建的Web Part，点击添加按钮。（如图）
之后，我们做好的Web Part就出现在SharePoint的站点界面中了。（如图）
自定义Web Part配置界面
SharePoint对于WebPart中的字符串、整数、浮点数等数据类型的属性，会自动在配置界面显示出一个文本框，对于枚举类型，SharePoint也会自动显示为一个下拉列表，对于布尔型，SharePoint也会自动显示复选框。
那可能还有其它的一些更复杂的类型怎么办哩？SharePoint也支持自定义WebPart的配置界面。此时就要用到EditorPart类了。
接着上面的工程，我们需要在工程里新建一个类，随便命一个名字：WebPartEditor，引入命名空间：System.Web.UI.WebControls.WebParts，并让这个类继承EditorPart类，并实现它的两个方法ApplyChanges和SyncChanges，简单描述：
- ApplyChanges：是由配置界面向WebPart传值；
- SyncChanges：是由WebPart向配置界面传值。
类WebPartEditor代码如下：
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.WebControls;
namespace VisualWebPartProject2
{
class WebPartEditor:EditorPart
{
DropDownList ddl_Text;
protected override void OnInit(EventArgs e)
{
//保证控件被创建
EnsureChildControls();
base.OnInit(e);
}
//创建控件
protected override void CreateChildControls()
{
Controls.Clear();
ddl_Text = new DropDownList();
ddl_Text.Items.Add("配置一");
ddl_Text.Items.Add("配置二");
Controls.Add(ddl_Text);
}
//绘制自定义配置界面的外观
protected override void RenderContents(System.Web.UI.HtmlTextWriter writer)
{
writer.Write("配置选项：");
ddl_Text.RenderControl(writer);
}
public override bool ApplyChanges()
{
return true;
//throw new NotImplementedException();
}
public override void SyncChanges()
{
//throw new NotImplementedException();
}
}
}
在WebPart类中，我们还需要实现IWebEditable接口的一个方法，注意，这个接口已经在WebPart类中引用了，我们这里只需要重写它CreateEditorParts方法，代码如下：
using System;
using System.ComponentModel;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using Microsoft.SharePoint;
using Microsoft.SharePoint.WebControls;
using System.Collections;
namespace VisualWebPartProject2.VisualWebPart1
{
[ToolboxItemAttribute(false)]
public class VisualWebPart1 : WebPart
{
// Visual Studio might automatically update this path when you change the Visual Web Part project item.
private const string _ascxPath = @"~/_CONTROLTEMPLATES/VisualWebPartProject2/VisualWebPart1/VisualWebPart1UserControl.ascx";
protected override void CreateChildControls()
{
Control control = Page.LoadControl(_ascxPath);
Controls.Add(control);
}
//自定义配置界面需重写此方法
public override EditorPartCollection CreateEditorParts()
{
ArrayList controlList = new ArrayList();
WebPartEditor ePart = new WebPartEditor();
//分配ID，要不然会报错
ePart.ID = this.ID + Guid.NewGuid().ToString();
controlList.Add(ePart);
return new EditorPartCollection(controlList);
}
}
}
这样，我们自定义的配置界面就做好了，效果如下图所示
