Sharepoint 2010 之 WebPart

时间:2024-06-17 17:07:43

转:http://blog.****.net/bestbadgod/article/details/6895542

Sharepoint系列的博客,都是我个人自学过程中的点滴的积累,毕竟没做过C#及Asp.net方面的开发,如有不正确的地方,还望大牛们斧正。

Sharepoint2010较Sharepoint2007,功能上有了很大的改善,无论在WebPart开发、自定义字段、事件的编写,等等等等,都进行了操作上得简化,使整个项目的建立、部署及调试,都变得极为的简单。

下面,就让我们开始Sharepoint2010中,WebPart开发的旅程吧。

1:事先的准备工作

首先,让我们创建网站集“http://moss:8000”,并在主页上创建员工信息列表,列表名称为“员工列表”,暂且让我们定义四个字段,分别为“员工编号”、“员工姓名”、“出生日期”和“家庭住址”。并添加两条记录,如下图所示:

Sharepoint 2010 之 WebPart
那么,本节咱们的工作目的,便是把该列表中的数据,全部(或部分),通过GridView展示到主页面上,让用户在登录系统后,就能非常清楚的看到他所关心的、或感兴趣的数据或内容。比如上面所说的员工的信息等。


2:创建WebPart

1) 打开VS2010,在新建项目界面,选择Visual C# →SharePoint→2010,点击右部的“可视Web部件”,并给项目起名“MyFirstWebPart”如下图所示:

Sharepoint 2010 之 WebPart



注:由于SharePoint2010是基于.NET Framework3.5的,所以,在进行Sharepoint2010的开发时,无论是WebPart、EventReceiver、还是自定义字段、控制台应用程序,都要选择.NET Framework3.5,而不是4.0,否则将无法引用Microsoft.Sharepoint命名空间(引用的Sharepoint.Dll无效)。

2)点击确定按钮后,将出现如下图所示对话框:
Sharepoint 2010 之 WebPart
在站点地址验证栏中输入你要部署(或调试)的站点地址,并点击验证按钮。在验证Moss地址无误后,点击完成按钮。



3)编写WebPart代码。首先,在完成上一步工作以后,就进入了编程页面。在页面上添加GridView控件,并修改其属性。如下图所示:

Sharepoint 2010 之 WebPart

由于列表中有4个字段,如果想全部显示到主也上的话,那么,咱们通过GridView的编辑列的功能,绑定4个字段,并分别设置HeaderText的值为“员工编号”,“员工姓名”,“家庭地址”和“出生年月”。设置DataField值为“Title”,“_x5458__x5de5__x59d3__x540d_”,“_x5bb6__x5ead__x4f4f__x5740_”和“_x51fa__x751f__x65e5__x671f_” 



==========================我是华丽的分界线========================================

写到这里,咱们不妨暂停一下,来看看“Title”,以及后面的“_x5458__x5de5__x59d3__x540d_”,“_x5bb6__x5ead__x4f4f__x5740_”和“_x51fa__x751f__x65e5__x671f_” 到底是何方神圣!首先,咱们在列表中定义了四个字段,分别为员工编号、员工姓名、家庭住址和出生年月,其中的员工编号字段,我是直接修改了列表自带的“标题”字段,所以,该字段名在数据库中显示为Title。而如果你用中文名来作为栏的名字时,Sharepoint会把中文名转换为xoooo的格式,其中oooo为对应的数字。那么咱们来看下如何获取中文字段名在数据库中对应的名字吧。

建立控制台应用程序,正如上面的注意点一样,记得选择.NET Framework3.5,而不是4.0   接下来,引用SharePoint.dll,路径为C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI\Microsoft.SharePoint.dll ,并引用其命名空间 
using Microsoft.SharePoint;  然后编写代码如下:

  1. static void Main(string[] args)
  2. {
  3. using (SPSite site = new SPSite("http://moss:8000"))     //http://moss:8000为你自己对应的网站集名称
  4. {
  5. using (SPWeb web = site.OpenWeb(""))                //如果你的网站不是在网站集下,需要site.OpenWeb("WebUrl")  WebUrl 为网站的Url
  6. {
  7. SPList list = web.Lists["员工列表"];
  8. foreach (SPField  field in list.Items.Fields )
  9. {
  10. Console.WriteLine("字段名:" +field.Title + "         InternalName:" + field.InternalName );
  11. }
  12. }
  13. }
  14. }
static void Main(string[] args)
{
using (SPSite site = new SPSite("http://moss:8000")) //http://moss:8000为你自己对应的网站集名称
{
using (SPWeb web = site.OpenWeb("")) //如果你的网站不是在网站集下,需要site.OpenWeb("WebUrl") WebUrl 为网站的Url
{
SPList list = web.Lists["员工列表"];
foreach (SPField field in list.Items.Fields )
{
Console.WriteLine("字段名:" +field.Title + " InternalName:" + field.InternalName );
}
}
}
}

运行控制台应用程序,得到如下结果:

Sharepoint 2010 之 WebPart

简单的说:在列表中所定义的字段名称(如果为汉字的话),其实相当于你的小名,而这个小名,是不能写到身份证中,他需要转换成Sharepoint能认识的名字(也就是你真正的名字)。通过上面代码的演示,你可以很容易的得到那一长串怪东西究竟是什么玩意儿了。



友情提示:如果你在执行控制台应用程序的时候,反复的,而且不知道什么原因的得到如下的错误提示的话:

Sharepoint 2010 之 WebPart

别害怕,选择解决方案下的类库→右键→属性,在【生成】页面下,修改“目标平台”为“Any CPU”就可以了。如下所示:

Sharepoint 2010 之 WebPart



==========================华丽的分界线Over========================================

闲话谈完了,继续编写咱们的WebPart代码:

  1. using System;
  2. using System.Web.UI;
  3. using System.Web.UI.WebControls;
  4. using System.Web.UI.WebControls.WebParts;
  5. using Microsoft.SharePoint;
  6. namespace MyFirstWebPart.VisualWebPart1
  7. {
  8. public partial class VisualWebPart1UserControl : UserControl
  9. {
  10. protected void Page_Load(object sender, EventArgs e)
  11. {
  12. if (!IsPostBack)
  13. {
  14. BindData();
  15. }
  16. }
  17. private void BindData()
  18. {
  19. SPSecurity.RunWithElevatedPrivileges(delegate() {
  20. SPList list = SPContext.Current.Web.Lists["员工列表"];
  21. SPQuery query = new SPQuery();
  22. query.ViewFields = "<FieldRef Name='Title' /><FieldRef Name='_x5458__x5de5__x59d3__x540d_' /><FieldRef Name='_x5bb6__x5ead__x4f4f__x5740_' /><FieldRef Name='_x51fa__x751f__x65e5__x671f_' />";
  23. this.GridView1.DataSource  = list.GetItems(query).GetDataTable();
  24. this.GridView1.DataBind();
  25. });
  26. }
  27. }
  28. }
using System;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using Microsoft.SharePoint; namespace MyFirstWebPart.VisualWebPart1
{
public partial class VisualWebPart1UserControl : UserControl
{
protected void Page_Load(object sender, EventArgs e)
{
if (!IsPostBack)
{
BindData();
} } private void BindData()
{
SPSecurity.RunWithElevatedPrivileges(delegate() {
SPList list = SPContext.Current.Web.Lists["员工列表"];
SPQuery query = new SPQuery();
query.ViewFields = "<FieldRef Name='Title' /><FieldRef Name='_x5458__x5de5__x59d3__x540d_' /><FieldRef Name='_x5bb6__x5ead__x4f4f__x5740_' /><FieldRef Name='_x51fa__x751f__x65e5__x671f_' />";
this.GridView1.DataSource = list.GetItems(query).GetDataTable();
this.GridView1.DataBind();
});
}
}
}

当然了,如果你对CAML不太熟悉,完全可以用下面代码来代替,这样将查处所有的字段。(CAML具有较强的条件查询、排序等功能)

  1. private void BindData()
  2. {
  3. SPSecurity.RunWithElevatedPrivileges(delegate() {
  4. SPList list = SPContext.Current.Web.Lists["员工列表"];
  5. //SPQuery query = new SPQuery();
  6. //query.ViewFields = "<FieldRef Name='Title' /><FieldRef Name='_x5458__x5de5__x59d3__x540d_' /><FieldRef Name='_x5bb6__x5ead__x4f4f__x5740_' /><FieldRef Name='_x51fa__x751f__x65e5__x671f_' />";
  7. //this.GridView1.DataSource  = list.GetItems(query).GetDataTable();
  8. this.GridView1.DataSource = list.GetItems().GetDataTable();
  9. this.GridView1.DataBind();
  10. });
  11. }
        private void BindData()
{
SPSecurity.RunWithElevatedPrivileges(delegate() {
SPList list = SPContext.Current.Web.Lists["员工列表"];
//SPQuery query = new SPQuery();
//query.ViewFields = "<FieldRef Name='Title' /><FieldRef Name='_x5458__x5de5__x59d3__x540d_' /><FieldRef Name='_x5bb6__x5ead__x4f4f__x5740_' /><FieldRef Name='_x51fa__x751f__x65e5__x671f_' />";
//this.GridView1.DataSource = list.GetItems(query).GetDataTable();
this.GridView1.DataSource = list.GetItems().GetDataTable();
this.GridView1.DataBind();
});
}

好了,代码及设计到此结束。下面修改一下咱们的WebPart在页面中的标题:

打开【VisualWebPart1.webpart】页面,修改Title属性为:<property name="Title" type="string">员工信息展示</property>

Sharepoint 2010 之 WebPart

在确认无误的情况下,选择解决方案 → 右键点击→部署解决方案。WebPart的编写及部署到此就告一段落。



3:页面上添加WebPart

该部分内容主要将以贴图的形式来介绍。

1)首先在浏览器中输入咱们的网站地址:http://moss:8000

Sharepoint 2010 之 WebPart2)点击网站操作右边的【页面】按钮,将显示页面对应的菜单:

Sharepoint 2010 之 WebPart

3)点击【编辑页面】按钮,将进入页面的设计阶段:

Sharepoint 2010 之 WebPart4)点击【添加Web部件】

Sharepoint 2010 之 WebPart5)在【类别】中选择【Custom】(用户自定义WebPart)

Sharepoint 2010 之 WebPart6)点击【员工信息展示】,并点击添加



Sharepoint 2010 之 WebPart

7)点击【停止编辑】按钮,并重新刷新主页,将在主页上显示列表,并展示出列表【员工列表】中的内容。

【列表内容】

Sharepoint 2010 之 WebPart

【首页Gridview内容】

Sharepoint 2010 之 WebPart



4:WebPart调试

webpart的调试比较简单,直接在需要调试的代码处设置断点,并按下F5,就可直接到达调试断点处。

Sharepoint 2010 之 WebPart





WebPart部分就为大家介绍到这里,希望对大家有所帮助!