【转】2.5SharePoint服务器端对象模型 之 访问网站和列表数据（Part 5）

（五）列表条目（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的方法，只返回其中某些指定字段的值以减少数据库操作来提高读取效率（严格的说，该方法其实并非只会返回我们所指定的字段内容，而是会忽略掉列表中除我们指定字段之外的所有查阅项（包括用户和用户组）类型的字段，因为在返回查阅项类型值的时候，底层数据库需要一些额外的查询）。该方法的定义为：

   1: public SPListItem GetItemByIdSelectedFields(
   2:                 int id, params string[] fields)

其中fields参数需要定义为内部名称。例如，当我们仅需要获取某列表中ID为23的条目的“标题”字段（内部名称为“Title”）时，可以使用如下的代码：

   1: SPListItem item = spList.GetItemByIdSelectedFields(23, "Title");
   2: Console.WriteLine(Convert.ToString(item["Title"]);

（3） 当已知列表条目的Guid的时候，可以通过SPList的GetItemByUniqueId(Guid id)方法，获取到对应的列表条目。

（4） 通过SPList的GetItems(SPView view)方法，获取某个列表的某个特定视图下的所有列表条目集合（返回SPListItemCollection类型）。注意这种方法获取到的列表条目集合只包含该视图中所包含的那些字段，而无法获取其他字段的内容。

（5）通过SPList的GetItems(SPQuery query)方法，根据指定的查询条件返回列表中满足该查询条件的列表条目集合（返回SPListItemCollection类型）。这种方法在开发过程中经常会使用到，应当熟练掌握，在本章第四节终会详细讲解SPQuery的用法。

 

 

2、列表条目的内容访问

当得到一个列表条目对应的SPListItem对象后，可以使用索引器来访问条目中相应字段的内容：

  • 使用item[fieldName]，根据字段的显示名称或内部名称获取该条目该字段的内容，返回值为object类型。
  • 使用item[fieldID]，根据字段的Guid获取该条目该字短的内容，返回值为object类型。

上述两种方法是一般获取列表条目内容最常用的两种手段（第一种更常用），但是获取的值都是object类型，需要转换为相应的实际类型后再进行输出。如果我们直接将这个object转换成字符串，我们会发现有些字段类型的值并不是在页面中显示的那样：比如对于一个多选类型字段，它的值可能是“;#选项1;#选项2;#”；而一个用户和用户组类型的字段，它的值可能会是“1;#Administrator”（1是该用户的ID，Administrator则是显示名称）。

当然，当我们了解了这些字段类型的内置格式之后，我们可以通过各种字符串处理的方法来得到我们所需要的显示结果。不过在SharePoint中还有一些更标准的方法。在栏/字段（SPField）章节的示例程序中，已经介绍了如何将object类型的值转换为相应的数据类型。除此之外，SharePoint的内置字段类型都提供了两个方法，可以直接将列表条目的内容转换为可以直接输出的内容，这两个方法是SPField的GetFieldValueAsText(object value)和GetFieldValueAsHtml(object value)，其区别在于前者显示纯文本的内容，而后者显示Html的内容（某些字段中可能会包含一些格式或超链接等Html内容）。例如，下面的程序展示了如何使用这种方法获取字段的显示内容（假设存在Chapters列表，其中包含标题、链接、创建者等字段）：

   1: using(SPSite site = new SPSite("http://sp2010/book"))
   2: {
   3:   using(SPWeb web = site.OpenWeb())
   4:   {
   5:     SPList list = web.Lists["Chapters"];
   6:     SPField txtField = list.Fields["标题"], 
   7:             lnkField = list.Fields["链接"],
   8:             userField = list.Fields["创建者"];
   9:     foreach(SPListItem item in list.Items)
  10:     {
  11:       Console.WriteLine(string.Format("{0}:{1} by {2}",
  12:         txtField.GetFieldValueAsText(item["标题"]),
  13:         lnkField.GetFieldValueAsHtml(item["链接"]),
  14:         userField.GetFieldValueAsText(item["创建者"])));
  15:     }
  16:   }
  17: }

需要说明的是，SPField的这两个方法并不能保证显示的样式和SharePoint内置的显示样式完全一致，而且在某些情况下，这种显示样式的输出是有问题的（比如“超链接和图片”类型中的图片）。实际上，SharePoint内置的显示样式控制是通过另外一种机制来实现的。

 

3、其他形式的内容访问

除了上述方法能够获取列表条目的内容之外，SharePoint对象模型中也提供了使用Xml形式以及DataTable形式访问列表条目内容的方法。

通过使用SPListItemCollection的Xml属性或SPListItem的Xml属性，可以获得一组或一个列表条目内容的Xml形式表示。在Xml形式的表示中，所有字段类型均使用字符串的格式输出其内容，而所有字段均使用内部名称，并在字段的内部名称前加上“ows_”这一前缀，例如：“ows_Title='Chapter1'”等。实际上，这种Xml的表示和使用Web Services的方式获取到的列表条目的内容是完全一致的。

在传统的ASP.NET开发过程中，开发人员最熟悉的数据结构是DataSet、DataTable等，因为它可以很方便地绑定到各种数据显示控件中。在SharePoint中，虽然使用了自己特有的一套对象模型来表示数据，但是为了和传统的数据绑定方式兼容，也提供了以DataTable形式获取列表数据的方法。

在通过各种方式获得到列表条目集合之后，可以调用SPListItemCollection的GetDataTable方法（不需要任何参数），将这些列表数据转换为DataTable。但是需要说明的是，转换出来的DataTable中的DataColumn的名称都是列表字段的内部名称；其次，使用该方法获得的DataTable中的数据格式，SharePoint会根据字段类型进行一些处理，例如将查阅项的文本获取出来隐去ID等，但是对于多选类型，依然没有进行很好的处理，在进行数据绑定的时候这些数据格式需要加以注意。虽然在控制台程序中没有办法很方便地输出DataTable中的数据，但是凭借Visual Studio的可视化调试功能，我们可以直观地在调试过程中查看整个DataTable的内容，如下图所示：

image

此外，在SharePoint 2010中为了更加方便何高效地使用DataTable来查看列表数据，在SPList中新增了GetDataTable和AppendDataTable两个方法，这两个方法的定义如下：

 

   1: public DataTable GetDataTable(SPQuery  query,
   2:                         SPListGetDataTableOptions flags,
   3:                         out SPListItemCollectionPosition position)
   4:  
   5: public void AppendDataTable(SPQuery query,
   6:                      SPListGetDataTableOptions flags,
   7:                      DataTable dataTable,
   8:                      out SPListItemCollectionPosition position)

从命名中就可以很直观地了解到这两个方法的作用：获取DataTable、追加内容到DataTable中。其中的几个通用参数的含义如下：

  • query（SPQuery）：指定返回列表条目时的查询、排序条件、条目数量限制等，并指定需要返回哪些字段的值。和查询相关的内容，将在本章第四节中进行详细介绍。
  • flags（SPListGetDataTableOptions）：返回DataTable数据时的一些选项，指定了如何返回布尔类型、查阅项类型和计算值类型的字段值。
  • position（SPListItemCollectionPosition）：返回查询后的分页信息。关于分页查询的详细内容，也将在本章第四节中进行详细介绍。

4、新建列表条目

列表条目的新建与其他类型对象的新建编辑有些不同（见第一节中集合操作的部分），列表条目新建的大致过程是：（1）调用SPListItemCollection的Add方法，返回一个待添加的条目（SPListItem类型），也可以使用SPList的AddItem方法（SharePoint 2010新增的方法），在执行该方法之后，列表条目并没有被添加到SharePoint中；（2）为各个需要设置值的字段设置值；（3）调用SPListItem的Update方法将新的列表条目添加到SharePoint中。

下面的程序展示了一个列表条目的创建过程。假设网站中存在Chapters列表，其中包含标题（单行文本）、作者（用户和用户组）、计划完成时间（日期和时间）等字段：

   1: using(SPSite site = new SPSite("http://sp2010/book"))
   2: {
   3:   using(SPWeb web = site.OpenWeb())
   4:   {
   5:     SPList list = web.Lists["Chapters"];
   6:     SPListItem newItem = list.Items.Add();
   7:     newItem["标题"] = "Ch02";
   8:     newItem["作者"] = 19;        // 19是某个用户的ID
   9:     newItem["计划完成时间"] = DataTime.Today.AddDays(10);
  10:     newItem.Update();
  11:   }
  12: }

需要指出的是，为列表条目的字段赋值的时候，并不强制要求所赋的值和列表字段的原始数据类型相同，例如对于“计划完成时间”这个时间日期类型的字段，可以直接设置成DateTime类型的值，也可以设置为形如“2009-9-9 10:10”这样的字符串（但是要保证格式正确），SharePoint会自动进行转换。在设置查阅项和人员类型的字段值的时候，其正确的数据类型应为SPFieldLookupValue / SPFieldUserValue（对于单选查阅项和单一的人员和组）或SPFieldLookupValueCollection / SPFieldUserValueCollection（对于多选查阅项和可以多选的人员和组），但是可以直接设置形如“1;#ItemTitle”或“1;#Administrator;#2;#”这样的值，对于单选的查阅项及人员和组，甚至可以直接设置相应的ID值，正如本例中所做的那样。

对于列表条目的编辑操作，设置值的过程是完全相同的。

SPListItemCollection的Add方法，以及SPList的AddItem方法，都提供了一些重载，用以创建文件夹，或者在指定文件夹下创建列表条目。关于文件夹相关的内容，将在本章第三节中进行详细介绍。

 

5、列表条目的常用属性

SPListItem的一些常用属性如下：

名称

类型

说明

Attachments

SPAttachmentCollection

列表条目的附件集合（详见第三节）

ContentType

SPContentType

列表条目的内容类型

DisplayName

string

列表条目的显示标题

Name

string

列表条目的名称

Title

string

列表条目的“标题”字段

Xml

string

列表条目的Xml表示

File

SPFile

列表条目对应的文档（详见第三节）

Folder

SPFolder

列表条目对应的文件夹（详见第三节）

列表条目的DisplayName、Name和Title三个属性有些类似，有兴趣的读者可以自行尝试一下他们在普通列表、文档库等类型的列表中各有什么关系和区别。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/439266.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

【转】3.3SharePoint服务器端对象模型 之 访问文件和文件夹（Part 3）

【转】3.3SharePoint服务器端对象模型 之 访问文件和文件夹（Part 3）

（三）遍历 文件系统的遍历是指按照文件夹的层级结构遍历文档库、列表的文件夹和列表条目。遍历主要有三种方式：（1）直接使用文件系统对象模型进行遍历；（2）使用SPDocumentLibrary进行遍…
阅读更多...
【LeetCode240、剑指offer04】二维数组中的查找（线性做法）

【LeetCode240、剑指offer04】二维数组中的查找（线性做法）

在一个 n * m 的二维数组中，每一行都按照从左到右递增的顺序排序，每一列都按照从上到下递增的顺序排序。请完成一个高效的函数，输入这样的一个二维数组和一个整数，判断数组中是否含有该整数。 示例: 现有矩阵 matrix 如下&#x…
阅读更多...
【转】4.2SharePoint服务器端对象模型 之 使用CAML进行数据查询（Part 2）

【转】4.2SharePoint服务器端对象模型 之 使用CAML进行数据查询（Part 2）

（三）使用SPQuery进行列表查询 1、概述 列表查询主要是指在一个指定的列表（或文档库）中按照某些筛选、排序条件进行查询。列表查询主要使用SPQuery对象，以及SPList的GetItems方法，将SPQuery作为参数传递&a…
阅读更多...
【转】理解SQL Server的安全对象和权限

【转】理解SQL Server的安全对象和权限

理解安全对象(Securable) 安全对象，是SQL Server 数据库引擎授权系统控制对其进行访问的资源。通俗点说，就是在SQL Server权限体系下控制的对象，因为所有的对象(从服务器，到表，到视图触发器等)都在SQL Server的权限体系…
阅读更多...
【NC14 按之字形顺序打印二叉树】

【NC14 按之字形顺序打印二叉树】

描述 给定一个二叉树&#xff0c;返回该二叉树的之字形层序遍历&#xff0c;&#xff08;第一层从左向右&#xff0c;下一层从右向左&#xff0c;一直这样交替&#xff09; 数据范围&#xff1a;0 \le n \le 15000≤n≤1500,树上每个节点的val满足 |val| < 100∣val∣<1…
阅读更多...
SharePoint 2010文档库批量下载文档的实现

SharePoint 2010文档库批量下载文档的实现

在SharePoint 2010文档库中&#xff0c;结合单选框&#xff0c;在Ribbon中提供了批量处理文档的功能&#xff0c;比如&#xff0c;批量删除、批量签出、批量签入等&#xff0c;但是&#xff0c;很遗憾&#xff0c;没有提供批量下载&#xff0c;如图: 若选中多个文档后&#xff…
阅读更多...
【LeetCode - 42. 接雨水】

【LeetCode - 42. 接雨水】

42. 接雨水 难度困难3164 给定 n 个非负整数表示每个宽度为 1 的柱子的高度图&#xff0c;计算按此排列的柱子&#xff0c;下雨之后能接多少雨水。 示例 1&#xff1a; 输入&#xff1a;height [0,1,0,2,1,0,1,3,2,1,2,1] 输出&#xff1a;6 解释&#xff1a;上面是由数组 […
阅读更多...
【LeetCode】第283场周赛题解

【LeetCode】第283场周赛题解

本场题题目不难&#xff0c;但是力求写出精简优雅的代码&#xff0c;还是有需要学习的地方的。 第一题 力扣 class Solution:def cellsInRange(self, s: str) -> List[str]:ans []a,b,c,d s[0],s[1],s[3],s[4]for i in range(ord(a), ord(c)1):for j in range(int(b),int…
阅读更多...
Linq to Sql : 三种事务处理方式

Linq to Sql : 三种事务处理方式

Linq to SQL支持三种事务处理模型&#xff1a;显式本地事务、显式可分发事务、隐式事务。(from MSDN: 事务 (LINQ to SQL))。MSDN中描述得相对比较粗狂&#xff0c;下面就结合实例来对此进行阐述。 0. 测试环境 OSWindows Server 2008 Enterprise sp1IDEVisual Studio 2008, …
阅读更多...
【LeetCode - 33】搜索旋转排序数组（二分）

【LeetCode - 33】搜索旋转排序数组（二分）

力扣 解题报告&#xff1a; 二分。但是有不少细节要考虑清楚。 所以干脆考虑另一种二分的方式。也就是第二次二分的时候&#xff0c;把两半数组给拼成一个完整的数组&#xff0c;当然下标需要是虚拟的&#xff0c;这一步可以用偏移量取模完成。这样就不需要考虑边界情况了。 …
阅读更多...
【LeetCode - 1765】. 地图中的最高点

【LeetCode - 1765】. 地图中的最高点

力扣 解题报告&#xff1a; 多元BFS。 进阶一下&#xff1a; 二维数组&#xff0c;1表示等高线&#xff0c;0表示平地&#xff0c;比如 输入 010 111 010 输出 010 121 010输入 010 101 010 输出 010 111 010即输入一个二维地图&#xff0c;保证等高线一定是闭合的环&#x…
阅读更多...
【转】微服务架构下分布式事务方案

【转】微服务架构下分布式事务方案

1 微服务的发展 微服务倡导将复杂的单体应用拆分为若干个功能简单、松耦合的服务&#xff0c;这样可以降低开发难度、增强扩展性、便于敏捷开发。当前被越来越多的开发者推崇&#xff0c;很多互联网行业巨头、开源社区等都开始了微服务的讨论和实践。Hailo有160个不同服务构成…
阅读更多...
【LeetCode - 443】压缩字符串（模拟）

【LeetCode - 443】压缩字符串（模拟）

解题报告&#xff1a; 直接模拟。 class Solution { public:int compress(vector<char>& chars) {int p 0;for(int i 0; i<chars.size();) {int j i1;while(j<chars.size() && chars[j] chars[i]) j;chars[p] chars[i];if(j-i > 1) {int cnt…
阅读更多...
Linq to SQL之使用事务

Linq to SQL之使用事务

事务是一个原子的工作单位&#xff0c;必须完整的完成单位里的所有工作&#xff0c;要么全部执行&#xff0c;要么全部都不执行。如果提交事务&#xff0c;则事务执行成功&#xff1b;如果回滚事务&#xff0c;则事务执行失败。 事务具备4个基本特性--ACID(原子性、一致性、孤立…
阅读更多...
【LeetCode - 798】得分最高的最小轮调（转化法）

【LeetCode - 798】得分最高的最小轮调（转化法）

解题报告&#xff1a; 思路一&#xff1a;这题首先说一个nlogn的方法。 首先一个主客转化&#xff0c;题目描述是说把数组做翻转&#xff0c;idx不变&#xff0c;然后nums[i]和i作比较。那么我们可以转化为让数组不变&#xff0c;idx转变&#xff0c;即&#xff1a;假设刚开始…
阅读更多...
【转】聊聊分布式事务，再说说解决方案

【转】聊聊分布式事务，再说说解决方案

前言 最近很久没有写博客了&#xff0c;一方面是因为公司事情最近比较忙&#xff0c;另外一方面是因为在进行 CAP 的下一阶段的开发工作&#xff0c;不过目前已经告一段落了。 接下来还是开始我们今天的话题&#xff0c;说说分布式事务&#xff0c;或者说是我眼中的分布式事务…
阅读更多...
【LeetCode - 2049】统计最高分的节点数目

【LeetCode - 2049】统计最高分的节点数目

解题报告&#xff1b; 直接dp。注意mx也得longlong AC代码&#xff1a; class Solution { public:vector<int> vv[200005];int sum[200005];long long ans[200005];int n;void dfs(int x) {ans[x] 1; sum[x] 1;for(int i 0; i<vv[x].size(); i) {dfs(vv[x][i]);s…
阅读更多...
【LeetCode每日一题】2024. 考试的最大困扰度

【LeetCode每日一题】2024. 考试的最大困扰度

​​​​​​力扣 解题报告&#xff1a; 因为只有T和F两个元素&#xff0c;不难证明单向性。尺取法解决。当然这题也可以二分。 AC代码&#xff1a; class Solution { public:int maxConsecutiveAnswers(string answerKey, int k) {int l 0, r 0;int T 0, F 0;int ans …
阅读更多...
2022-08-20-网易笔试题

2022-08-20-网易笔试题

写在前面 题目收集来源自网络&#xff0c;前四题是开发岗的&#xff0c;后四题是算法岗的&#xff0c;因为代码无处提交&#xff0c;不一定正确&#xff0c;就不贴出来了&#xff0c;这里只写一下我的思路吧~欢迎大家一起讨论~~ 1、 思路&#xff1a;因为最大1e9&#xff0c…
阅读更多...
TUN/TAP设备浅析(一) -- 原理浅析

TUN/TAP设备浅析(一) -- 原理浅析

TUN/TAP设备浅析 TUN设备 TUN 设备是一种虚拟网络设备&#xff0c;通过此设备&#xff0c;程序可以方便地模拟网络行为。TUN 模拟的是一个三层设备,也就是说,通过它可以处理来自网络层的数据&#xff0c;更通俗一点的说&#xff0c;通过它&#xff0c;我们可以处理 IP 数据包…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023