SharePoint 2010中新增的GetItemByIdSelectedFields方法

2019-11-17 03:49:41

字體：大中小

來源：轉載

供稿：網友

唔……事先聲明，其實這篇文章沒有太多實際的使用意義，所以想了解某個東東怎么用的同學可以按Alt + F4（或者Ctrl + W）了。想了解SharePoint里面是怎么工作的同學可以繼續往下翻。

最近正在和KB一起寫關于SharePoint 2010開發方面的一本書，在研究2010新增加的對象模型的時候，偶然發現了這個方法。我們都知道在2003/2007里面，根據ID獲取列表條目使用的是SPList的GetItemById方法（什么，沒聽說過這個方法？那恐怕你不是一個合格的SharePoint開發人員……）。新增加的這個方法名字叫GetItemByIdSelectedFields（同時也增加了一個GetItemByIdAllFields的方法與之作伴，不過這個和GetItemById是完全等效的，就不再廢話了），方法的定義是這樣的：

   1: public SPListItem GetItemByIdSelectedFields(int id, params string[] fields)
當我第一眼看到這個的時候，立刻就想到了SPQuery的那個ViewFields屬性，獲取某個列表條目的時候，只返回某些指定的字段，來提高效率?？墒钱斘覍懥藗€Console程序試驗的時候，發現并不是我想象中的樣子，比如我寫成（這個方法要求寫內部名稱）：

   1: SPListItem item = spList.GetItemByIdSelectedFields(1, "Title", "Created");   2: Console.WriteLine(item["Modified"]);

這段程序居然沒有報錯，而且Modified的值也正常返回了，于是我試了試，一個自定義列表里面居然有50來個字段的值都正常返回了，但是所有的查閱項、用戶和用戶組（其實這個本質上也是查閱項）都沒有返回。

在好奇驅使下（暫時還害不死我），我Reflector了一下這個方法的源代碼：

   1: if(field == null)   2: {   3:   throw new ArgumentNullException("fields");   4: }   5:     6: StringBuilder builder = new StringBuilder();   7: foreach (string str in fields)   8: {   9:   if (str != null)  10:   {  11:     builder.Append("<FieldRef Name=/"" + str + "/"/>");  12:   }  13: }  14:    15: foreach (SPField field in this.Fields)  16: {  17:   bool flag = false;  18:   foreach (string str2 in fields)  19:   {  20:     if (str2 == field.InternalName)  21:     {  22:       flag = true;  23:       break;  24:     }  25:   }  26:   if (!flag && field.MustFetchByDefault)  27:   {  28:     builder.Append("<FieldRef Name=/"");  29:     builder.Append(field.InternalName);  30:     builder.Append("/"/>");  31:   }  32: }  33:    34: return this.GetItemById(id, null, false, builder.ToString());
關于最后那個GetItemById是怎么回事，暫時先不用再去深究了，只要知道它是一個GetItemById的重載，目的就是查找條目用的就行了，最后一個參數把需要獲取的字段以CAML的形式放進去。

第7行那個foreach很好理解，把我們需要的字段加進去；但是第15行的那個foreach一開始就有點讓人摸不著頭腦了，還要把其他字段也放進去？而且SPField的這個MustFetchByDefault是什么東西？再挖挖看看：

   1: internal bool MustFetchByDefault   2: {   3:   get   4:   {   5:     string fieldAttributeValue = this.GetFieldAttributeValue("List");   6:     if(!string.IsNullOrEmpty(fieldAttributeValue) &&   7:        (fieldAttrbuteValue != GlobalList.Docs.ToString()))   8:     {   9:       return false;  10:     }  11:     return true;  12:   }  13: }

如何判斷一個字段是不是要取呢？通過判斷字段的一個List屬性，至于GetFieldAttributeValue方法就不再往上貼了（否則有騙字數的嫌疑），總之它是從Field的類似Schemaxml屬性（字段描述）的Xml結點中，去找一個List的屬性。如果找到了，而且不是GlobalList.Docs（某個特殊的東東）的話，那么這個字段就不是必須的，換句話說這個字段我就不用返回給用戶。

那什么字段的SchemaXml里會有List屬性？一個字段里有一個和列表的屬性？查閱項！哈，真的是回避掉了所有的查閱項。（Docs這個東西是“路徑”這個字段的List屬性，估計有某些特殊的來源）

現在我們知道為什么會包含其他所有字段，并且不包含查閱項了。但是為什么要這樣？如果我們對SharePoint的內容數據庫有所了解的話，我們會知道其實查閱項在內容數據庫里只存了一個ID值在AllUserData表里面（但是用對象模型取出來的時候，是包含查閱那個條目相應字段的內容的），這也就意味著，如果要返回查閱項的值，就需要多做一些額外的數據庫操作（比如再去找到被查閱的那個條目，把相應字段的值返回來，拼裝成“1;#Administrator“這種鬼樣子）。更重要的是，如果這個查閱項是一個多值的，那么這個查閱項本身都是保存在另外一個表中的（AllUserDataJunctions），這樣要返回起來還真是要費不少功夫。所以2010里面新增加了這么一個東西，如果我們的列表中包含好多個查閱項，而我們可能暫時只用到其中一兩個（或者一個都不用）的話，看來用這個方法確實能提高不少效率。

上一篇：潘希光：WordPress插件的提交和更新

下一篇：Syncfusion Essential DocIO操作word文件實用函數