使用SharePoint Client OM来查询列表的注意事项(2)
2 min read

使用SharePoint Client OM来查询列表的注意事项(2)

上一篇文章提到了使用Client OM来查询SharePoint列表时需要两次指定结果集里包含的字段,范例是C#调用托管的Client OM,本文来介绍一下如何JavaScript来调用Client OM查询列表。

先创建几个全局变量:


var tf_contex;
var tf_list;
var tf_items;

然后是一个初始化的函数:


function DoQuery() {
tf_context = new SP.ClientContext.get_current();
tf_list = tf_context.get_web().get_lists().getByTitle("TestList");

var query = new SP.CamlQuery();
query.set_viewXml("<View><ViewFields><FieldRef Name='Entity_SysCode'/></ViewFields><Query><Where><Contains><FieldRef Name='_x822a__x73ed_'/><Value Type='Text'>"
+ "CA1143"
+ "</Value></Contains></Where></Query></View>");

tf_items = tf_list.getItems(query);

tf_context.load(tf_items, "Include(Entity_SysCode,_x8f66__x8f86__x724c__x7167_,_x822a__x73ed_)");

tf_context.executeQueryAsync(onListsLoaded, onQueryFailed);
}

可以发现使用JavaScript来调用Client OM和使用托管代码很像,我们依然要两次指定结果集里要包含的字段,第一次是在CamlQuery.set_viewXml方法中,第二次是在clientContext.load方法中。

最后在调用context.executeQueryAsync方法时,传递了两个方法引用,第一个会在executeQueryAsync执行成功时触发,第二个则是在发生错误时触发,这两个方法的代码如下:


function onListsLoaded() {
var items = tf_items.getEnumerator();
while (items.moveNext()) {
alert(item.get_item("Entity_SysCode"));
}
}

function onQueryFailed(sender, args) {
alert('Request failed. \nError: ' + args.get_message() + '\nStackTrace: ' + args.get_stackTrace());
}

当然,仅仅这样还是不够的,还得让页面执行上面的初始化函数,因为JavaScript Client OM定义在SP.js这个文件中,所以我们还得确保这个文件已经被加载完毕,Client OM专门提供了一个方法来做这件事情:


SP.SOD.executeOrDelayUntilScriptLoaded(DoQuery, "SP.js");

SharePoint 2010提供的Client OM是一套强大而又便利的API,使用Client OM,以前我们在SharePoint上进行的许多展示型开发,现在只需要一个存放代码的文档库,再搭配SharePoint内置的“内容编辑器”Web部件”就可以做到,再也不需要服务器的管理权限了。