强大的SPGridView

先看看SPGridView能实现的效果：
1）分组,分页

2）下拉菜单

3）过滤

以上效果是不是跟系统的列表一模一样？

SPGridView继承于GrieView，拥有GridView的所有功能，并扩展了以上功能。

下面讲述SPGridView的两种用法：采用自定义数据源和采用WSS的列表作为数据源。

利用SPGridView显示自定义数据源

Step1：
新建一个页面，写入如下内容：

<%@ Page MasterPageFile="~/_layouts/application.master" Language="C#" AutoEventWireup="true" CodeFile="SPGridViewTest.aspx.cs" Inherits="_Default" %>

<%@ Register Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"

Namespace="Microsoft.SharePoint.WebControls" TagPrefix="cc1" %>

<asp:Content ID="Content1" ContentPlaceHolderID="PlaceHolderMain" runat="server">

<cc1:SPGridView ID="SPGridView1" runat="server" AutoGenerateColumns="False" AllowPaging="True" PageSize="3" >

</cc1:SPGridView>

<cc1:SPGridViewPager ID="SPGridViewPager1" runat="server" GridViewId="SPGridView1">

</cc1:SPGridViewPager></div>

</asp:Content>

注意：
SPGridView不支持自动生成列，所以一定要设置AutoGenerateColums为false。
SPGridView直接启用了分页，并且，页面放入一个SPGrieViewPager，来实现分页。
Step2：
在CodeFile里写一个提供测试数据的函数：

using Microsoft.SharePoint;
using Microsoft.SharePoint.WebControls;

public DataTable GetDataTable()

{

DataTable tblData = new DataTable();

tblData.Columns.Add("Title");

tblData.Columns.Add("Author");

tblData.Columns.Add("Rating");

tblData.Rows.Add("Obsession", "Robards, Karen", 2);

tblData.Rows.Add("Vanished", "Robards, Karen", 3);

tblData.Rows.Add("Magician: Apprentice", "Feist, Raymong E.", 4);

tblData.Rows.Add("Magician: Master", "Feist, Raymong E.", 5);

tblData.Rows.Add("Silverthorn", "Feist, Raymong E.", 4);

tblData.Rows.Add("Lord Foul's Bane", "Donaldson, Stephen R.", 3);

tblData.Rows.Add("The Illearth War", "Donaldson, Stephen R.", 4);

return tblData;

}

Step3：
在Page_Load里写代码，加入ObjectDataSource控件，用这个控件来调用上面的GetDateTable函数。

ObjectDataSource odsDataSource = new ObjectDataSource();

odsDataSource.ID = "ExampleSource";

odsDataSource.TypeName = this.GetType().FullName + "," + this.GetType().Assembly.FullName;

odsDataSource.SelectMethod = "GetDataTable";

Controls.Add(odsDataSource);

有人可能要奇怪了，为什么要用ObjectDataSource来调用GetDataTable，直接给SPGridView的DataSource属性赋值不行吗？
答案是：可以的。但是，那样的话，你就不的不再写一些代码来处理SPGridView的过滤和排序事件。而ObjectDataSource是可以自动来处理这些事件的。
Step4：继续在Page_Load写代码，设置SPGridView的过滤格式和过滤属性，如果不这样设置的话，过滤功能不会起效（这个设置可是我起早摸黑，用reflector看它的代码才发现的...）。

//{0}表示过滤值，{1}表示过滤字段值

SPGridView1.FilteredDataSourcePropertyFormat = "{1}='{0}'";

SPGridView1.FilteredDataSourcePropertyName = "FilterExpression" ;

SPGridView1.EnableViewState = false;

Step4：继续在Page_Load写代码，添加字段，并启用排序：

//添加字段

SPBoundField col = new SPBoundField();

col.DataField = "Title";

col.SortExpression = "Title";

col.HeaderText = "Title";

SPGridView1.Columns.Add(col);

col = new SPBoundField();

col.DataField = "Author";

col.SortExpression = "Author";

col.HeaderText = "Author";

SPGridView1.Columns.Add(col);

col = new SPBoundField();

col.DataField = "Rating";

col.SortExpression = "Rating";

col.HeaderText = "Rating";

SPGridView1.Columns.Add(col);

SPGridView1.AllowSorting = true;

Step5：设置过滤字段：

SPGridView1.AllowFiltering = true;

SPGridView1.FilterDataFields = ",Author,Rating";

注意：开始的列如果不启用过滤需要加 “，”。

Step6：继续在Page_Load写代码，设置分组：

//设置分组

SPGridView1.AllowGrouping = true;

SPGridView1.AllowGroupCollapse = true;

SPGridView1.GroupField = "Title";

SPGridView1.GroupDescriptionField = "Title";

SPGridView1.GroupFieldDisplayName = "分组:";

Step7：Continue...,添加一个有下拉菜单的字段：

//添加下拉菜单字段

SPMenuField colMenu = new SPMenuField();

colMenu.HeaderText = "Presenter Name";

colMenu.TextFields = "Title";

//指定关联的菜单ID

colMenu.MenuTemplateId = "PresenterListMenu";

colMenu.NavigateUrlFields = "Title,Rating";

colMenu.NavigateUrlFormat = "do.aspx?p={0}&q={1}";

colMenu.TokenNameAndValueFields = "EDIT=Title,NAME=Rating";

colMenu.SortExpression = "Title";

//菜单

MenuTemplate presenterListMenu = new MenuTemplate();

presenterListMenu.ID = "PresenterListMenu";

//菜单项

MenuItemTemplate biogMenu = new MenuItemTemplate(

"Read Biography", "/_layouts/images/EawfNewUser.gif");

biogMenu.ClientOnClickNavigateUrl = "do.aspx?this=%EDIT%&that=%NAME%";

//entry.ClientOnClickScript = "your javascript here";

presenterListMenu.Controls.Add(biogMenu);

//菜单项

MenuItemTemplate broadcastMenu = new MenuItemTemplate(

"Recent Broadcasts", "/_layouts/images/ICWM.gif");

presenterListMenu.Controls.Add(broadcastMenu);

//分割线

MenuSeparatorTemplate sepMenu = new MenuSeparatorTemplate();

presenterListMenu.Controls.Add(sepMenu);

//菜单项

MenuItemTemplate favMenu = new MenuItemTemplate(

"Add to Favorites", "/_layouts/images/addtofavorites.gif");

presenterListMenu.Controls.Add(favMenu);

this.Controls.Add(presenterListMenu);

SPGridView1.Columns.Add(colMenu);

Step8：绑定数据源：

//绑定数据源

this.SPGridView1.DataSourceID = "ExampleSource";

this.SPGridView1.DataBind();

OK，可以看效果了～
注意：SPGridView一定要在WSS的环境中使用，所以各位做测试的时候需要把页面放到layouts中。
整个Page_Load的代码如下：

Page_Load

protected void Page_Load(object sender, EventArgs e)

{

ObjectDataSource odsDataSource = new ObjectDataSource();

odsDataSource.ID = "ExampleSource";

odsDataSource.TypeName = this.GetType().FullName + "," + this.GetType().Assembly.FullName;

odsDataSource.SelectMethod = "GetDataTable";

Controls.Add(odsDataSource);

//{0}表示过滤值，{1}表示过滤字段值

SPGridView1.FilteredDataSourcePropertyFormat = "{1}='{0}'";

SPGridView1.FilteredDataSourcePropertyName = "FilterExpression" ;

SPGridView1.EnableViewState = false;

//添加字段

SPBoundField col = new SPBoundField();

col.DataField = "Title";

col.SortExpression = "Title";

col.HeaderText = "Title";

SPGridView1.Columns.Add(col);

col = new SPBoundField();

col.DataField = "Author";

col.SortExpression = "Author";

col.HeaderText = "Author";

SPGridView1.Columns.Add(col);

col = new SPBoundField();

col.DataField = "Rating";

col.SortExpression = "Rating";

col.HeaderText = "Rating";

SPGridView1.Columns.Add(col);

SPGridView1.AllowSorting = true;

SPGridView1.AllowFiltering = true;

SPGridView1.FilterDataFields = ",Author,Rating";

//设置分组

SPGridView1.AllowGrouping = true;

SPGridView1.AllowGroupCollapse = true;

SPGridView1.GroupField = "Title";

SPGridView1.GroupDescriptionField = "Title";

SPGridView1.GroupFieldDisplayName = "分组:";

//添加下拉菜单字段

SPMenuField colMenu = new SPMenuField();

colMenu.HeaderText = "Presenter Name";

colMenu.TextFields = "Title";

//指定关联的菜单ID

colMenu.MenuTemplateId = "PresenterListMenu";

colMenu.NavigateUrlFields = "Title,Rating";

colMenu.NavigateUrlFormat = "do.aspx?p={0}&q={1}";

colMenu.TokenNameAndValueFields = "EDIT=Title,NAME=Rating";

colMenu.SortExpression = "Title";

//菜单

MenuTemplate presenterListMenu = new MenuTemplate();

presenterListMenu.ID = "PresenterListMenu";

//菜单项

MenuItemTemplate biogMenu = new MenuItemTemplate(

"Read Biography", "/_layouts/images/EawfNewUser.gif");

biogMenu.ClientOnClickNavigateUrl = "do.aspx?this=%EDIT%&that=%NAME%";

//entry.ClientOnClickScript = "your javascript here";

presenterListMenu.Controls.Add(biogMenu);

//菜单项

MenuItemTemplate broadcastMenu = new MenuItemTemplate(

"Recent Broadcasts", "/_layouts/images/ICWM.gif");

presenterListMenu.Controls.Add(broadcastMenu);

//分割线

MenuSeparatorTemplate sepMenu = new MenuSeparatorTemplate();

presenterListMenu.Controls.Add(sepMenu);

//菜单项

MenuItemTemplate favMenu = new MenuItemTemplate(

"Add to Favorites", "/_layouts/images/addtofavorites.gif");

presenterListMenu.Controls.Add(favMenu);

this.Controls.Add(presenterListMenu);

SPGridView1.Columns.Add(colMenu);

//绑定数据源

this.SPGridView1.DataSourceID = "ExampleSource";

this.SPGridView1.DataBind();

}

利用SPGridView显示列表的数据

只要把数据源控件换成SPDataSource，然后利用SPDataSource连接相应的列表即可：

SPDataSource odsDataSource = new SPDataSource();

odsDataSource.ID = "ExampleSource";

Controls.Add(odsDataSource);

SPSite site = new SPSite("http://ssjin073:9032");

SPList list = site.RootWeb.GetListFromUrl("http://ssjin073:9032/Lists/List/AllItems.aspx");

odsDataSource.List = list;

整个Page_Load代码如下：

protected void Page_Load(object sender, EventArgs e)

{

SPDataSource odsDataSource = new SPDataSource();

odsDataSource.ID = "ExampleSource";

Controls.Add(odsDataSource);

SPSite site = new SPSite("http://ssjin073:9032");

SPList list = site.RootWeb.GetListFromUrl("http://ssjin073:9032/Lists/List/AllItems.aspx");

odsDataSource.List = list;

Response.Write(SPGridView1.FilterFieldName);

SPGridView1.FilteredDataSourcePropertyFormat = "{1}='{0}'";

SPGridView1.FilteredDataSourcePropertyName = "FilterExpression" ;

this.SPGridView1.AutoGenerateColumns = false;

SPGridView1.EnableViewState = false;

//添加字段

SPBoundField col = new SPBoundField();

col.DataField = "标题";

col.SortExpression = "标题";

col.HeaderText = "标题";

SPGridView1.Columns.Add(col);

col = new SPBoundField();

col.DataField = "Origin";

col.SortExpression = "Origin";

col.HeaderText = "Origin";

SPGridView1.Columns.Add(col);

SPGridView1.AllowSorting = true;

SPGridView1.AllowFiltering = true;

SPGridView1.FilterDataFields = ",标题";

//设置分组

SPGridView1.AllowGrouping = true;

SPGridView1.AllowGroupCollapse = true;

SPGridView1.GroupField = "Origin";

SPGridView1.GroupDescriptionField = "Origin";

SPGridView1.GroupFieldDisplayName = "分组:";

//添加下拉菜单字段

SPMenuField colMenu = new SPMenuField();

colMenu.HeaderText = "Presenter Name";

colMenu.TextFields = "标题";

//指定关联的菜单ID

colMenu.MenuTemplateId = "PresenterListMenu";

//colMenu.NavigateUrlFields = "标题";

// colMenu.NavigateUrlFormat = "do.aspx?p={0}&q={1}";

//colMenu.TokenNameAndValueFields = "EDIT=Title,NAME=Rating";

//colMenu.SortExpression = "Title";

//菜单

MenuTemplate presenterListMenu = new MenuTemplate();

presenterListMenu.ID = "PresenterListMenu";

//菜单项

MenuItemTemplate biogMenu = new MenuItemTemplate(

"Read Biography", "/_layouts/images/EawfNewUser.gif");

biogMenu.ClientOnClickNavigateUrl = "do.aspx?this=%EDIT%&that=%NAME%";

//entry.ClientOnClickScript = "your javascript here";

presenterListMenu.Controls.Add(biogMenu);

//菜单项

MenuItemTemplate broadcastMenu = new MenuItemTemplate(

"Recent Broadcasts", "/_layouts/images/ICWM.gif");

presenterListMenu.Controls.Add(broadcastMenu);

//分割线

MenuSeparatorTemplate sepMenu = new MenuSeparatorTemplate();

presenterListMenu.Controls.Add(sepMenu);

//菜单项

MenuItemTemplate favMenu = new MenuItemTemplate(

"Add to Favorites", "/_layouts/images/addtofavorites.gif");

presenterListMenu.Controls.Add(favMenu);

this.Controls.Add(presenterListMenu);

SPGridView1.Columns.Add(colMenu);

//绑定数据源

this.SPGridView1.DataSourceID = "ExampleSource";

this.SPGridView1.DataBind();

}

注意：此代码要正常运行，测试用的列表必须有标题和Origin两个字段。
除了用代码给SPGridView添加字段，适应于GridView的一切手段都是可以应用到SPGridView的，
比如，你可以添加一个模板字段（TemplateFiled），模板内容当然可以按需控制了。

下载所有示例代码：https://files.cnblogs.com/jianyi0115/PageTest.rar

posted on 2008-04-03 21:06 jianyi 阅读(10704) 评论(57) 编辑收藏举报