WSS3SDK之：Mobile开发中的省略号与渲染限制

在移动设备的查看器中，如果某字段的文本长度超过了web.config(位于Local_Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS\MOBILE目录)中的限制，WSS就会显示省略号。在mobile的列表项编辑窗体中包含大量数据，WSS会根据字段类型来禁用字段的编辑功能来避免由于内容超过特定限制导致的数据丢失。无论是上面的哪种情况，mobile渲染的限制决定了在mobile设备上哪些内容会显示。
图1.文本的切断和省略号渲染

您可以修改文本的长度限制，进而改变其在mobile视图或窗体中的渲染效果。有两种方式供您选择，一是可以在一个文本编辑器中编辑web.config文件，二是通过使用WSS对象模型中的类型和成员来修改。
渲染限制不但定义了用于mobile控件的省略号渲染的文本长度限制，还包括控件的许多其他显示选项。关于渲染限制和他们的默认值的详细清单，请参考本文末尾的表格。
每个显示设定由web.config文件中<appSettings>节中的一个名-值对儿来表示。比如，<add key="mobile_webtitlelimit" value="20" />。如果文本长度限制的配置设为0或没有指定，省略号渲染将无效。
注意：
如果要修改这些属性值，您必须在WSS部署的所有前端web服务器上修改mobile web.confg文件，才能使变更生效。

使用对象模型来配置限制

 渲染限制由两种方式之一来决定，其一是mobile web.config文件中的默认配置设定，其二是通过对象模型为各个网站配置Web属性。您对web.config的修改是全局的，基于前端web服务器层次的。而Web属性的变更是在网站层次的，不会继承到子网站。
为了允许对网站级的渲染限制的定制，WSS首先会确定Web属性中是否存储渲染限制参数。如果是，那么就用该Web属性值存储的渲染限制；否则，就使用存在web.config的渲染限制。特定网站的Web属性设定会覆盖web.config中的全局设定。
如果要修改一个mobile控件的渲染限制，可以使用Microsoft.SharePoint.SPWeb类的Properties属性返回一个属性包(Microsoft.SharePoint.Utilities.SPPropertyBag)对象，包含了给定网站的所有配置。下面的例子展示了如何变更指定网站的列表标题的渲染限制为15个字符。
C#

SPWeb webSite = SPContext.Current.Site.AllWebs["WebSite"];
SPPropertyBag propBag = webSite.Properties;
propBag["mobile_listtitlelimit"] = "15";
propBag.Update();

上面的例子需要引用Microsoft.SharePoint和Microsoft.SharePoint.Utilities命名空间。而且要在对应的自定义Web应用程序的default.aspx中插入一个FormDigest控件。

渲染限制

 

下表描述了用于mobile页面中的渲染限制参数及其默认的最大值。

名称	描述	值
基本渲染限制
mobile_basetextlengthlimit	文本长度的基本限制	255
系统渲染限制
mobile_enablelimitationondispform	在显示窗体中渲染省略号的开关	FALSE
mobile_fieldnumberlimitforinputform	在新建/编辑窗体中显示的字段数量限制	100
mobile_fieldtitlelimit	字段标题的限制 (显示在窗体中)	20
mobile_itemtitlelimit	列表项标题的限制 (显示在窗体中)	20
mobile_listtitlelimit	列表标题的限制(显示在列表视图中)	20
mobile_viewitemnumberlimit	显示在列表视图中的列表项数量限制	100
mobile_viewnumberlimit	视图选择器中的视图数量限制 (显示在列表视图中)	10
mobile_viewtitlelimit	视图选择器中的视图标题限制 (显示在列表视图中)	20
mobile_webtitlelimit		20
字段相关限制
mobile_attachmentsfieldnumberlimit	显示的附件数量限制	3
mobile_attachmentsfieldtextlimit	单个附件文件名称的长度限制	20
mobile_calculatedfieldtextlimit	计算值型的字段长度限制	20
mobile_choicefieldoptionnumberlimit	选项类型的字段在新建或编辑窗体中显示的项数限制	10
mobile_choicefieldoptiontextlimit	选项字段中某个选项的标题长度限制	20
mobile_fieldtextlimitforview	在视图中某字段值的长度限制	19
mobile_filefieldtextlimit	文件字段的值得人长度限制	20
mobile_lookupfieldoptionnumberlimit	查阅项类型的字段在新建或编辑窗体中显示的项数限制	10
mobile_lookupfieldoptiontextlimit	查阅项字段中某个选项的长度限制	20
mobile_multichoice_displaylimitforselectedchoices		10
mobile_multilinetextfieldtextlimit	多行文本字段值的长度限制	256
mobile_multilookup_displaylimitforselectedlookups		10
mobile_multiuser_displaylimitforselectedusers		100
mobile_singlelinetextfieldtextlimit	单行文本字段值的长度限制	256
mobile_urlfieldtextlimit	URL字段值的长度限制	20
mobile_userfieldoptionnumberlimit	用户类型的字段在新建或编辑窗体中显示的项数限制	100
mobile_userfieldoptiontextlimit	用户字段中某个选项的标题长度限制	20

注意：
上表的字符限制单位是字符数，不管是对于半角或全角字符都是一样。