本文将演示如何执行一个带有筛选器定义的外部内容类型的Finder方法。
步骤
1、使用SharePoint Designer 2010创建一个新的外部内容类型,使用AdventureWorks2000数据库的Employees表。 为该ECT在First Name一栏上设置一个筛选器。
请注意,我们选中了复选框“如果为以下值,则忽略筛选器”。
2、打开Visual Studio 2010并从SharePoint2010项目分类中选择新建一个“可视 Web 部件”项目。
3、在该webpart用户控件的设计模式下,添加一些文字“First Name:”。然后拖放一个文本框和一个按钮。设置文本框的ID为FirstNameTextbox,按钮的ID为SearchButton。最后,添加一个GridView。完成后的界面如下图:
4、我们需要添加一个引用到Microsoft.BusinessData.dll,在解决方案资源管理器中右击“引用”文件夹,选择“添加引用”。 浏览到该dll:
c:\program files\common files\microsoft shared\web server extensions\14\ISAPI\Microsoft.BusinessData.dll
5、打开用户控件—— VisualWebPart1UserControl.ascx.cs,添加下列using语句:
using Microsoft.SharePoint;
using Microsoft.SharePoint.BusinessData.SharedService;
using Microsoft.BusinessData.MetadataModel;
using Microsoft.SharePoint.Administration;
using Microsoft.BusinessData.Runtime;
using Microsoft.SharePoint.BusinessData.Runtime;
6、添加下列方法:
private void executeFilterMethod()
{
//获取实体的目录以便开始我们的工作
BdcService service = SPFarm.Local.Services.GetValue<BdcService>();
IMetadataCatalog catalog = service.GetDatabaseBackedMetadataCatalog(SPServiceContext.Current);
//获取Employee外部内容类型
IEntity entity = catalog.GetEntity("http://contoso14", "Employee");
//获得默认的Finder方法的筛选器
IFilterCollection filters = entity.GetDefaultFinderFilters();
//如果FirstNameTextBox有值则设置筛选器值
if (FirstNameTextBox.Text != string.Empty)
{
WildcardFilter filter = (WildcardFilter)filters[0];
filter.Value = FirstNameTextBox.Text;
}
//通过默认的Finder方法返回筛选后的数据
IEntityInstanceEnumerator enumerator = entity.FindFiltered(filters, entity.GetLobSystem().GetLobSystemInstances()[0].Value);
DataTable table = null;
//循环遍历返回的数据
while (enumerator.MoveNext())
{
//第一次时设置数据表,以后直接添加行
if (table == null)
table = enumerator.Current.EntityAsDataTable;
else
table.ImportRow(enumerator.Current.EntityAsDataTable.Rows[0]);
}
//绑定数据到我们的GridView
GridView1.DataSource = table;
GridView1.DataBind();
}
7、双击我们用户控件上的按钮,添加一个点击事件处理程序,内容很简单,直接调用上面的方法即可:
protected void SearchButton_Click(object sender, EventArgs e)
{
executeFilterMethod();
}
8、所有的代码工作都完成了,现在我们可以按F5键运行了。Visual Studio会帮我们打成wsp包并部署到我们的网站。
当 SharePoint打开后,进入页面编辑模式,插入一个webpart。我们的VisualWebPart1位于Custom分组下。添加好后,点击 Button按钮,你将会从Employee外部内容类型返回所有的数据,或者也可以输入一个first name比如Linda,就会返回符合条件的结果:
在接下来的文章中,我们会进一步介绍bcs的对象模型。