关于Shareppoint客户端对象模型和Shareppoint根据内部名称获取字段值的随笔

实际上，每个SharePoint字段实际上有两个名称，一个是“标题”（Title，有时候也把它叫做“显示名称”），一个是“内部名称”（Internal Name）。平时用户在列表视图界面上看到的，都是字段的标题。字段的内部名称可以看作是字段的唯一标识。如果你曾经使用SharePoint对象模型，通过代码从列表中获取数据，那么对“内部名称”这个概念一定很熟悉。基本上，SharePoint对“内部名称”的格式有非常严格的要求，它只能由英文字母、数字和下划线字组成，且不能包含空格。但是“标题”则没有这么多限制，通常我们会使用中文作为字段的“标题”，而且“标题”中很可能会包含空格。当一个字段被创建之后，它的“内部名称”就被固定下来了，但是“标题”则可以在之后被随时修改。

（1）下面先说Sharepoint的内部名称和显示名称：

　　   SPList list = SPSite.Lists["测试"];
          string strField = list.Fields.GetFieldByInternalName("Title");   // 使用字段的内部名称来获取一个字段

　　    // 使用字段的标题来获取一个字段，注意，GetField()会先尝试内部名称，然后再尝试使用标题进行查找
          string statusField = list.Fields.GetField("状态");

获取字段的内部名称的方法：

很简单，只要进入列表设置，对字段进行编辑，在地址栏就能看到一个“Field=ItemGuid”的参数，这表示“ItemGuid”字段的内部名称就是“ItemGuid”。

（2）我们来看Shareppoint客户端对象模型中的内部名称，下面直接上代码：

using System;
　　 using System.IO;
  　  using System.Collections.Generic;
　　 using System.Linq;
　　 using System.Text;
    　using Microsoft.SharePoint.Client;

　　 namespace ObjectClientModelTest
           {
              class Program
              {
                static void Main(string[] args)
                {
                    //Basic setup and test
                   using (ClientContext clientContext = new ClientContext("http://XXXXXXXXXXX"))
                   {
                      try
                      {
                        //Get Web
                        Web oWebsite = clientContext.Web;
                        clientContext.Load(oWebsite);
                        clientContext.ExecuteQuery();

//Get List
                        List oDocLib = clientContext.Web.Lists.GetByTitle("Shared Documents");
                        clientContext.Load(oDocLib);

//Get ListItems
                        CamlQuery camlQuery = new CamlQuery();
                        camlQuery.ViewXml = @"<Query><Where><Neq><FieldRef Name='ID' /><Value Type='Counter'>null</Value></Neq></Where></Query>";
                        ListItemCollection listItems = oDocLib.GetItems(camlQuery);
                        clientContext.Load(listItems);
                        clientContext.ExecuteQuery();

//Get all Word document
                        foreach (ListItem item in listItems)
                        {
                           //Get folder of the file

// 使用字段的内部名称来获取一个字段的值
                           string strDisplay = item.FieldValues[“Title”].ToString();
                           string fileDirRef = (Guid)item["UniqueId"].ToString();  //获取ListItem的ItemGuid

　　　　　　      string strItemGuid =  item["FileRef"].ToString().ToString();
                       } 
                  }  //try
                  catch(Exception ex)
                  {
                       Console.WriteLine(ex.Message);
                  }  //cache
             } //using           
        }   //main

} //Program

}