(五)列表条目(SPListItem)

SharePoint中数据的存储基本上都是通过列表条目来完成(文档库中的文档也是一种特殊的列表条目),因此在SharePoint应用开发中,最终是要和列表条目打交道的。在SharePoint对象模型中,使用SPListItem表示列表条目,使用SPListItemCollection表示列表条目集合。

 

1、列表条目的获取

列表条目的获取有多种方式,一些常用方式如下:

(1) 通过SPList的Items属性,获取列表中的所有条目(不包括文件夹本身对应的条目),再通过foreach遍历的形式遍历其中的所有条目;或使用形如[idx]的int型索引器获取其中的某个条目。当我们需要遍历一个列表中所有条目、或文档库中所有文档的时候(不论它们属于哪个子文件夹),我们就可以使用Items属性获取到全部列表条目(或文档)的集合。关于SharePoint列表中文件夹的一些特性,会在下一节进行详细介绍。

(2) 当已知列表条目ID的时候,可以通过SPList的GetItemById(int ID)方法,或SPListItemCollection的GetItemById(int ID)方法,获取到对应的列表条目。每个列表条目在本列表中都有一个唯一的整型ID。

需要说明的是,使用GetItemById方法获取到的条目,是包含列表中所有字段的值的。因此,在SharePoint 2010种,提供了一个名为GetItemByIdSelectedFields的方法,只返回其中某些指定字段的值以减少数据库操作来提高读取效率(严格的说,该方法其实并非只会返回我们所指定的字段内容,而是会忽略掉列表中除我们指定字段之外的所有查阅项(包括用户和用户组)类型的字段,因为在返回查阅项类型值的时候,底层数据库需要一些额外的查询)。该方法的定义为:

public SPListItem GetItemByIdSelectedFields(
string[] fields)

相关文章: