SharePoint服务器端对象模型 之 访问网站和列表数据（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”的列表，并且其中至少存在一个条目）：

))

   2: {

using(SPWeb web = site.OpenWeb())

   4:   {

];

   6:     SPListItem item = list.Items[0];

in list.Fields)

   8:     {

if(field.Type == SPFieldType.DateTime)

  10:       {

  11:         DateTime dtValue = Convert.ToDateTime(item[field.Id]);

// use dtValue

  13:       }

if(field.Type == SPFieldType.Url)

  15:       {

new SPFieldUrlValue(

  17:           Convert.ToString(item[field.Id]));

string url = urlValue.Url;

// use url

  20:       }

  21:     }

  22:   }

  23: }