使用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部件”就可以做到，再也不需要服务器的管理权限了。