SharePoint开发中可能用到的各种Context（上下文）

bestjoe

　　电脑正在以无比慢的速度从微软网站上安装Office Component for Visual Studio 2012，今晚的某个工作看来是干不成了，索性写篇blog。
　　SharePoint是一个B/S结构的产品，所以在开发过程中会使用到各种各样的上下文（Context）信息，借此机会来总结一下。
　　一、HttpContext
　　这个……我想就不用再介绍了，SharePoint运行在标准的ASP.NET框架下（2003用的不是标准的ASP.NET 1.1，不过这年头还有人用2003么），所以这个对象的使用和ASP.NET没有任何区别。
　　
　　二、SPContext
　　从名字就可以看出来，这个是SharePoint自己的上下文对象，它除了封装了HttpContext之外，提供了很多和SharePoint相关的上下文信息。
　　SPContext包含一个我们最经常使用的静态属性：SPContext.Current，用于获取当前的上下文信息（和HttpContext.Current类似，如果程序是运行在Web上的，就可以使用这个）。我见过不少初学SharePoint开发的人，在写WebPart的时候，还在使用new SPSite的方式来获取当前网站集，这即没有必要，也是对服务器资源的浪费（SPSite、SPWeb对象都包含非托管资源，而Current中的Site和Web是被SharePoint自己的运行时环境所管理的，可以快速取用）。
　　下面看一下这个SPContext中包含哪些常用的属性，可以在开发过程中使用（有些属性其实内部逻辑很复杂，这里简要介绍一些基本场景）：
  

属性	说明
Site	SPSite类型，次常用到的属性，当前的网站集
Web	SPWeb类型，最常用到的属性，当前的网站。          很多程序都是用SPContext.Current.Web来开头的……
List / ListId	SPList / Guid类型，当前列表。          不论你是在列表的视图页面上、表单页面上还是设置页面上，都可以通过这个属性取得当前的列表。其实只要Url查询里面有一个有效的List参数，参数的值是列表的Guid就可以。
ListItem / ItemId	SPListItem / Int32类型，当前的列表条目。          一般用于列表的查看和编辑表单（当然新建表单其实也可以，只不过没有ID），或者用于获取存放在页面库里的当前页面对应的条目。此外，如果当前的List属性有效的话，只要Url查询里面有一个有效的ID参数，就可以使用这个属性得到对应条目。
ListItemVersion	SPListItemVersion类型，当前列表条目对应的版本。          如果是从历史版本查看页面中，查看某个版本的条目时，在那个查看页面，可以用这个属性直接取到相应的版本。
ListItemDisplayName /          ListItemServerRelativeUrl	string / string类型，当前条目的显示名称（如果是普通列表，就是Title字段的值；如果是文档库，就是不带扩展名的文件名；或者是文件夹名称），以及Url。
File	SPFile类型，如果当前条目是一个文件的话，这个属性可以直接得到文件对象。          相当于SPContext.Current.ListItem.File
RootFolderUrl	string类型，当前视图对应的Url地址。          如果当前列表视图是处于列表的某个子文件夹中，可以通过这个属性得到这个文件夹的地址；否则的话，就是当前列表的根文件夹地址。
IsPopUI	Boolean类型，判断当前页面是否在对话框中。          仅限SharePoint 2010那种对话框，不包括浏览器的那种模态对话框。
FormContext	SPFormContext类型，当前列表表单上下文（用于列表表单页面）          一般可以使用这么几个属性：              FormMode：表单类型，New / Edit / Display              FieldControlCollection：表单上字段控件的集合
ViewContext	SPViewContext类型，当前视图上下文（用于列表视图页面）          一般可以使用这么几个属性：              View：SPView对象，当前的视图              ViewId：视图的Guid
ContextPageInfo	SPContextPageInfo类型，当前页面上下文（用于页面库中的页面）          一般可以使用这么几个属性：              ListId：页面所在文档库的Id              ItemId：当前页面作为列表条目的Id              BasePermissions：当前用户对当前页面的权限              IsWebWelcomePage：当前页面是否是网站的首页

  　　
　　三、JavaScript中的“ctx”
　　这个在微软的SDK里面是没有提及到的，在所有包含列表视图的Web部件页上，每个列表视图都会对应一个ctx[blabla]的JavaScript变量，后面那个[blabla]是一个数字，这个数字也是这个变量的ctxId属性。这些ctx变量都放在一个全局JavaScript变量g_ctxDict这个对象中，其key就是变量名字符串，value就是这个变量，因此便利这个全局变量，就能通过JavaScript找到当前页面中的所有视图。
　　ctx变量名义上是一个叫ContextInfo的JavaScript“类”，它包含非常丰富的属性，常用的一些如下：
  

属性	说明
ctxId	一个标识此变量的数字，比如185，那么这个变量就是ctx185。使用的时候可以用ctx185或者g_ctxDict[‘ctx185’]来找到这个变量（某些情况下有种更简便的方法，后面再说）。需要注意的是，每次刷新页面的时候，这个标识可能是会变的，具体原理我暂时木有去深究。
listBaseType	列表的基础类型，相当于SPList的BaseType属性
listTemplate	列表的模版Id（比如文档库是101、通知是104），相当于SPList的BaseTemplate属性
listName	列表的Id，不要被变量名混淆了
view	列表视图的Id
listUrlDir	列表的根路径，相当于spList.RootFolder.ServerRelativeUrl
HttpRoot	当前网站的根路径（绝对路径）
SiteTitle	当前网站的标题
ListTitle	列表的标题（这个才是标题，listName不是）
CurrentUserId	当前用户的Id
wpq	渲染视图那个WebPart的ID，比如WPQ2
ListData	这个就厉害了，这个属性指向一个数组，而这个数组就是当前视图显示的那些列表条目，包含各个字段的值，JSON格式。
ListSchema	列表各个字段的定义（包含字段名称、字段类型等等），JSON格式。
BasePermissions	当前用户对这个列表的基本权限，形如下面这种样子：          {ManageLists: true, ManagePersonalViews: true, OpenItems: true}

  　　后面加

的那几个是SharePoint 2013新增的属性。
　　其实在包含列表视图的页面中，还有一个名字就叫“ctx”的变量，它指向这个页面中最后一个ctx[blabla]变量，因此如果页面中只有一个列表视图的话，就可以直接使用ctx。比如在某个列表视图页面中，你想看一下这个列表模版的Id是多少，就可以直接在浏览器地址栏里输入：javascript:alert(ctx.listTemplate) ，嗯。
　　ctx变量最主要的作用，就是生成列表项的那个下拉菜单（ECB – Edit Control Block），如果你去翻那个corev4.js的话，就可以看到在创建那个下拉菜单的时候，ctx是作为参数传进去的。如果需要自定义列表项菜单的话，除了使用Feature的方式、或者2010新增的那个通过SPD添加Custom Action的方式，还可以使用从2007时代延续下来的JavaScript方式：在页面中添加Custom_AddListMenuItems方法或者Custom_AddDocLibMenuItems方法（具体使用请自行搜索），而ctx就是这两个方法的参数之一。
　　除此之外，作为列表视图中重要的JavaScript变量，通过在页面中嵌入的一些脚本中使用ctx，还可以完成各种比较邪恶的事情，请大家自行发挥想象。
　　
　　四、JavaScript中的_spPageContextInfo变量
　　同样是一个没有文档的JavaScript变量，虽然名字和前面提到的某个服务器端类型差不多，但是这个JavaScript变量里面所包含的内容，要比SPContextPageInfo多很多，它包含如下一些常用属性：
  

属性	说明
webServerRelativeUrl	网站的相对服务器路径（“/”开头）
currentLanguage	当前网站的语言LCID
webUIVersion	当前网站的UI风格（2010/2013风格是4，如果母板页是2007风格是3）
pageListId	页面库的列表Id
pageItemId	如果当前页面是在页面库中的话，当前页面作为列表条目的Id
webAbsoluteUrl	网站绝对路径（“http://”或者“https://”开头）
siteAbsoluteUrl	网站集绝对路径（“http://”或者“https://”开头）
layoutsUrl	layouts的相对服务器路径（2013其实有两个layouts root路径，一个是15，一个是14）
webTitle	网站标题
webPermMasks	当前用户对当前网站的权限，形如：{High:2147483647,Low:4294967295}          （因为JavaScript不支持64位整数，所以把高位和地位拆开了）
siteServerRelativeUrl	网站集的相对服务器路径（“/”开头）

  　　后面加

的那几个是SharePoint 2013新增的属性。
　　_spPageContextInfo变量主要的使用场景，就是在JavaScript中获取当前页面的一些基本信息，尤其在发布页面中，会有比较多的使用价值。
　　
　　五、其他JavaScript全局变量
　　页面中其实还有一些全局的JavaScript变量，也可以获取到当前的一些上下文信息：
  

变量	说明
g_wsaLCID	当前的语言，相当于_spPageContextInfo.currentLanguage
g_wsaSiteTemplateId	当前网站所使用的站点模版，比如“STS#1”表示工作组网站
_spUserId	当前用户的Id，这个JavaScript变量其实是右上角那个欢迎菜单渲染出来的
_spWebPermMasks	当前用户对当前网站的权限，相当于_spPageContextInfo.webPermMasks