Sharepoint 2010 之 WebPart

来源：互联网发布：java生成临时文件编辑：程序博客网时间：2024/04/29 17:41

Sharepoint系列的博客，都是我个人自学过程中的点滴的积累，毕竟没做过C#及Asp.net方面的开发，如有不正确的地方，还望大牛们斧正。
Sharepoint2010较Sharepoint2007，功能上有了很大的改善，无论在WebPart开发、自定义字段、事件的编写，等等等等，都进行了操作上得简化，使整个项目的建立、部署及调试，都变得极为的简单。
下面，就让我们开始Sharepoint2010中，WebPart开发的旅程吧。
1：事先的准备工作
首先，让我们创建网站集“http://moss:8000”,并在主页上创建员工信息列表，列表名称为“员工列表”，暂且让我们定义四个字段，分别为“员工编号”、“员工姓名”、“出生日期”和“家庭住址”。并添加两条记录，如下图所示：

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

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

注：由于SharePoint2010是基于.NET Framework3.5的，所以，在进行Sharepoint2010的开发时，无论是WebPart、EventReceiver、还是自定义字段、控制台应用程序，都要选择.NET Framework3.5，而不是4.0，否则将无法引用Microsoft.Sharepoint命名空间（引用的Sharepoint.Dll无效）。
2）点击确定按钮后，将出现如下图所示对话框：

在站点地址验证栏中输入你要部署（或调试）的站点地址，并点击验证按钮。在验证Moss地址无误后，点击完成按钮。

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

由于列表中有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; 然后编写代码如下：

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能认识的名字（也就是你真正的名字）。通过上面代码的演示，你可以很容易的得到那一长串怪东西究竟是什么玩意儿了。

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

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

==========================华丽的分界线Over========================================
闲话谈完了，继续编写咱们的WebPart代码:

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具有较强的条件查询、排序等功能）

        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>