新河seo怎么做整站排名,移动端的网站怎么做的,app设计策划书,在常州 做兼职上什么网站#xff08;四#xff09;栏/字段 SharePoint中的字段#xff08;中文版中叫做“栏”#xff09;与传统的数据栏类似#xff0c;也有不同类型的区别#xff0c;不过SharePoint中内置的栏类型除了按照数据类型#xff08;如数字、日期和时间等#xff09;进行区分之外四栏/字段 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的服务器资源管理器中我们可以很直观地看到这些重名的字段如下图。 而内部名称则是由SharePoint根据用户输入的显示名称按照一定的命名规律自动生成的用户无法干预这个过程。内部名称只能包含大小写英文字母、数字和下划线这三类字符对于其他的字符基本上以Unicode编码的形式表现这里之所以说“基本上”是因为其中还存在着许多例外情况比如创建一个名叫“num1”的字段内部名称会变成“_x006e_um1”。因此我们不能够以这种“基本上”的规则去根据一个字段显示名称来“推测”出它的内部名称。例如一个显示名称叫“My Field”的字段其内部名称可能是“My_x0020_Field”而一个显示名称为“中文”的字段其内部名称可能是“_x4e2d__x6587_”。字段的内部名称在SharePoint网站中很少有机会被查看到但是通过使用Visual Studio的服务器资源管理器在编写程序的过程中就可以非常方便地查看到我们选定字段的内部名称如下图所示。 在字段创建之后其内部名称是不会改变的即使将该字段重命名之后更改的也只是其显示名称内部名称依然保留原有的名称。并且在一个列表中字段的内部名称是不可能重复的读者可以自己做一些试验。 虽然列表字段的内部名称在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 Nullablebool 是否在列表条目的查看页面显示此字段 ShowInEditForm Nullablebool 是否在列表条目的编辑页面显示此字段 ShowInNewForm Nullablebool 是否在列表条目的新建页面显示此字段 SPField的ShowInDisplayForm / ShowInEditForm / ShowInNewForm三个属性在实际项目中面临的需求中可能经常会使用到。使用SharePoint列表搭建的应用在有些情况下一些字段可能会要求不显示在查看界面中仅供后台程序使用或者不显示在新建界面中由程序指定初始值或者不显示在编辑界面中不允许用户修改。通过这三个属性就可以实现这些需求。