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>节中的一个名-值对儿来表示。比如，<addkey="mobile_webtitlelimit" value="20"/>。如果文本长度限制的配置设为0或没有指定，省略号渲染将无效。
注意：
如果要修改这些属性值，您必须在WSS部署的所有前端web服务器上修改mobile web.confg文件，才能使变更生效。

 

使用对象模型来配置限制

 

 渲染限制由两种方式之一来决定，其一是mobileweb.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

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