【转】2.4SharePoint服务器端对象模型 之 访问网站和列表数据(Part 4)

(四)栏/字段

SharePoint中的字段(中文版中叫做“栏”)与传统的数据栏类似,也有不同类型的区别,不过SharePoint中内置的栏类型除了按照数据类型(如数字、日期和时间等)进行区分之外,更多的是从应用类型(货币、选项、查阅项等)进行分类。除内置的字段类型之外,SharePoint同样允许我们通过开发的方式实现自定义字段类型的扩展。在SharePoint中使用SPField表示字段,使用SPFieldCollection表示字段集合,内置的字段类型使用SPFieldType枚举表示。

 

1、字段相关类

在SharePoint中,SPField作为字段的基础类型,包括了字段的基本元素和基本属性。对于每一种特定的字段类型,在SharePoint中都有相应的类与之对应。这些类都是SPField直接或间接的字类,这些类的命名也都是以SPField开头。例如表示单行文本的SPFieldText、表示选项的SPFieldChoice、表示查阅项的SPFieldLookup等,完整的继承关系可以参看SDK中关于SPField的描述。不同的特定类中,包含了对相应字段类型的设置属性,例如针对数字字段类型的最大值、最小值属性,就包含在SPFieldNumber的MaximumValue和MinimumValue两个属性中。

对于一些普通字段类型,其值类型都是比较简单的数据,例如单行文本、多行文本字段是字符串类型(string)的值,数值字段是数值类型(double)的值,时间日期字段是时间日期类型(DateTime)的值。但是诸如超链接、查阅项、人员和组这些字段类型的值难以使用一个简单的类型表示,在SharePoint中,针对这些字段有专门的值类型,其名称为字段类+Value,例如表示超链接值的SPFieldUrlValue、表示查阅项值的SPFieldLookupValue等。

下面的程序展示了如何获取日期类型和人员和组类型的值,注意其区别(假设网站中存在一个叫做“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 item = list.Items[0];
   7:     foreach(SPField field in list.Fields)
   8:     {
   9:       if(field.Type == SPFieldType.DateTime)
  10:       {
  11:         DateTime dtValue = Convert.ToDateTime(item[field.Id]);
  12:         // use dtValue
  13:       }
  14:       else if(field.Type == SPFieldType.Url)
  15:       {
  16:         SPFieldUrlValue urlValue = new SPFieldUrlValue(
  17:           Convert.ToString(item[field.Id]));
  18:         string url = urlValue.Url;
  19:         // use url
  20:       }
  21:     }
  22:   }
  23: }

在上面的程序中,使用到了一些和列表条目相关的操作,虽然尚未介绍,但应当很容易理解其含义。

 

2、关于显示名称和内部名称

每一个SharePoint字段都有一个显示名称(SPField的Title属性)和一个内部名称(SPField的InternalName属性),这两个都是字符串类型的属性。

显示名称是在创建字段的时候,由用户指定的名称,没有特定的要求。通过网页创建字段的时候,显示名称是不允许重复的,但通过代码完全可以创建显示名称相同的多个字段,而实际上,每个列表中本身就包含了一些显示名称相同的字段(如自定义列表的“标题”字段、文档库的“名称”字段等),在Visual Studio的服务器资源管理器中,我们可以很直观地看到这些重名的字段(如下图)。

image

而内部名称则是由SharePoint根据用户输入的显示名称,按照一定的命名规律自动生成的(用户无法干预这个过程)。内部名称只能包含大小写英文字母、数字和下划线这三类字符,对于其他的字符,基本上以Unicode编码的形式表现(这里之所以说“基本上”,是因为其中还存在着许多例外情况,比如创建一个名叫“num1”的字段,内部名称会变成“_x006e_um1”。因此我们不能够以这种“基本上”的规则,去根据一个字段显示名称来“推测”出它的内部名称)。例如一个显示名称叫“My Field”的字段,其内部名称可能是“My_x0020_Field”,而一个显示名称为“中文”的字段,其内部名称可能是“_x4e2d__x6587_”。字段的内部名称在SharePoint网站中很少有机会被查看到,但是通过使用Visual Studio的服务器资源管理器,在编写程序的过程中就可以非常方便地查看到我们选定字段的内部名称(如下图所示)。

image

在字段创建之后,其内部名称是不会改变的,即使将该字段重命名之后,更改的也只是其显示名称,内部名称依然保留原有的名称。并且,在一个列表中,字段的内部名称是不可能重复的(读者可以自己做一些试验)。

虽然列表字段的内部名称在SharePoint使用过程中几乎体会不到,但是在SharePoint开发中,有很多场景必须要使用字段的内部名称来指定一个字段(比如列表查询),因此要熟悉内部名称的查看和使用方法。在实际项目中创建字段的时候,尽可能先使用英文创建字段(保证其内部名称看起来有意义而且容易记忆)再修改其显示名称为中文。

 

3、字段的获取

获取字段的方式一般都是先通过SPList的Fields属性获取到列表中所有字段的集合(SPFieldCollection类型),再使用如下方法获取其中某个特定的字段:

(1) Fields[idx]:int型索引器,使用下标获取字段,很少使用;

(2) Fields[displayName]:string型索引器,使用字段的显示名称获取;

(3) 使用Fields.GetField(string name)方法,使用字段的内部名称或显示名称获取(优先判断内部名称);

(4) 使用Fields.GetFieldByInternalName(string internalName)方法,使用字段的内部名称获取字段。

除此之外,我们还可以通过SPFieldCollection的ContainsField方法,根据字段的显示名称或内部名称,来判断某个特定名称的字段是否存在。

 

4、字段的常用属性

SPField的常用属性如下:

名称

类型

说明

InternalName

string

字段的内部名称

Title

string

字段的显示名称

Type

SPFieldType

字段的类型

Required

bool

字段是否为必填

SchemaXml

string

字段的通用属性描述

ShowInDisplayForm

Nullable<bool>

是否在列表条目的查看页面显示此字段

ShowInEditForm

Nullable<bool>

是否在列表条目的编辑页面显示此字段

ShowInNewForm

Nullable<bool>

是否在列表条目的新建页面显示此字段

SPField的ShowInDisplayForm / ShowInEditForm / ShowInNewForm三个属性在实际项目中面临的需求中可能经常会使用到。使用SharePoint列表搭建的应用,在有些情况下,一些字段可能会要求不显示在查看界面中(仅供后台程序使用),或者不显示在新建界面中(由程序指定初始值),或者不显示在编辑界面中(不允许用户修改)。通过这三个属性就可以实现这些需求。

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

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

相关文章

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

&#xff08;五&#xff09;列表条目&#xff08;SPListItem&#xff09; SharePoint中数据的存储基本上都是通过列表条目来完成&#xff08;文档库中的文档也是一种特殊的列表条目&#xff09;&#xff0c;因此在SharePoint应用开发中&#xff0c;最终是要和列表条目打交道的…

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

&#xff08;三&#xff09;遍历 文件系统的遍历是指按照文件夹的层级结构遍历文档库、列表的文件夹和列表条目。遍历主要有三种方式&#xff1a;&#xff08;1&#xff09;直接使用文件系统对象模型进行遍历&#xff1b;&#xff08;2&#xff09;使用SPDocumentLibrary进行遍…

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

在一个 n * m 的二维数组中&#xff0c;每一行都按照从左到右递增的顺序排序&#xff0c;每一列都按照从上到下递增的顺序排序。请完成一个高效的函数&#xff0c;输入这样的一个二维数组和一个整数&#xff0c;判断数组中是否含有该整数。 示例: 现有矩阵 matrix 如下&#x…

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

&#xff08;三&#xff09;使用SPQuery进行列表查询 1、概述 列表查询主要是指在一个指定的列表&#xff08;或文档库&#xff09;中按照某些筛选、排序条件进行查询。列表查询主要使用SPQuery对象&#xff0c;以及SPList的GetItems方法&#xff0c;将SPQuery作为参数传递&a…

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

理解安全对象(Securable) 安全对象&#xff0c;是SQL Server 数据库引擎授权系统控制对其进行访问的资源。通俗点说&#xff0c;就是在SQL Server权限体系下控制的对象&#xff0c;因为所有的对象(从服务器&#xff0c;到表&#xff0c;到视图触发器等)都在SQL Server的权限体系…

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

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

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

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

【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场周赛题解

本场题题目不难&#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支持三种事务处理模型&#xff1a;显式本地事务、显式可分发事务、隐式事务。(from MSDN: 事务 (LINQ to SQL))。MSDN中描述得相对比较粗狂&#xff0c;下面就结合实例来对此进行阐述。 0. 测试环境 OSWindows Server 2008 Enterprise sp1IDEVisual Studio 2008, …

【LeetCode - 33】搜索旋转排序数组(二分)

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

【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】压缩字符串(模拟)

解题报告&#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之使用事务

事务是一个原子的工作单位&#xff0c;必须完整的完成单位里的所有工作&#xff0c;要么全部执行&#xff0c;要么全部都不执行。如果提交事务&#xff0c;则事务执行成功&#xff1b;如果回滚事务&#xff0c;则事务执行失败。 事务具备4个基本特性--ACID(原子性、一致性、孤立…

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

解题报告&#xff1a; 思路一&#xff1a;这题首先说一个nlogn的方法。 首先一个主客转化&#xff0c;题目描述是说把数组做翻转&#xff0c;idx不变&#xff0c;然后nums[i]和i作比较。那么我们可以转化为让数组不变&#xff0c;idx转变&#xff0c;即&#xff1a;假设刚开始…

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

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

【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. 考试的最大困扰度

​​​​​​力扣 解题报告&#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-网易笔试题

写在前面 题目收集来源自网络&#xff0c;前四题是开发岗的&#xff0c;后四题是算法岗的&#xff0c;因为代码无处提交&#xff0c;不一定正确&#xff0c;就不贴出来了&#xff0c;这里只写一下我的思路吧~欢迎大家一起讨论~~ 1、 思路&#xff1a;因为最大1e9&#xff0c…