SPField的几种name的释疑

编写SharePoint Object Model代码时, 经常要用到SPField. 这个SPField有不少名字, 让人很容易混淆.

• Display Name
• Internal Name
• Name
• ColName
• StaticName

下面就让我们总结一下吧.

using (SPSite site = new SPSite("http://servername/sites/testsite")) { using (SPWeb web = site.OpenWeb()) { SPList splist = web.Lists["issue tracking1"]; FileStream fs = new FileStream(@"C:/temp/listschema.xml", FileMode.Create); StreamWriter sw = new StreamWriter(fs); sw.Write(splist.Fields.SchemaXml); }

你可以使用下面的代码把列表的FieldSchema捞出来看一下.

这个文件比较大, 我就抽选两个Field来作为例子:

<Field ID="{1df5e554-ec7e-46a6-901d-d85a3881cb18}" ColName="tp_Author" RowOrdinal="0" ReadOnly="TRUE" Type="User" List="UserInfo" Name="Author" DisplayName="Created By" SourceID="http://schemas.microsoft.com/sharepoint/v3" StaticName="Author" FromBaseType="TRUE"/>

和

<Field ID="{3881510a-4e4a-4ee8-b102-8ee8e2d0dd4b}" ColName="tp_CheckoutUserId" 
       RowOrdinal="0" ReadOnly="TRUE" Type="User" List="UserInfo" 
       Name="CheckoutUser" DisplaceOnUpgrade="TRUE" 
       DisplayName="Checked Out To" 
       SourceID="http://schemas.microsoft.com/sharepoint/v3" 
       StaticName="CheckoutUser" FromBaseType="TRUE"/>
 
这里可以看到这个field的全部信息, 如果你对某个列表的field的某个名字不清楚, 可以使用捞xml的大招来释疑.

我写过一篇文章, 叫做SPQuery 在引用field的时候要用internal name , 那么SPQuery用到的Internal Name是哪一个呢?

 

Name = Internal Name	Display Name	ColName	StaticName
SPQuery使用的名字	界面上显示的名字	数据库中对应的列名	不知道做什么的, 看了好几个都与Name, Internal Name一样.
CheckoutUser	Checked Out To	tp_CheckoutUserId	CheckoutUser
Author	Created By	tp_Author

 

应用

================

读写Field时

 

写代码时应用如下:

SPListItemCollection oitems = splist.Items; foreach (SPListItem oitem in oitems) { //Use display name here. string oAutorStr = oitem["Created By"].ToString(); Console.WriteLine(); }

===========================

编写SPQuery时

 

对应的代码如下:

SPQuery query = new SPQuery(); query.Query = "<Where>" + "<Eq>" + "<FieldRef Name='StatusInternal'/>" + "<Value Type='Text'>Good</Value>" + "</Eq>" + "</Where>"; SPListItemCollection items = splist.GetItems(query);

 

以上代码均通过了测试.

 

注意, 如果是在页面中使用javascript调用web service来查询list item, 那么通常返回结果中XML里, field的名字会在前面加上ows_前缀

 

如果您觉得清楚了, 那我的功夫就没白费. 呵呵.