省略号和呈现限制
上次修改时间: 2015年3月9日
适用范围: SharePoint Foundation 2010
当字段的文本长度超过在移动 web.config 文件(位于 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\MOBILE 中)中设置的限制时,SharePoint Foundation 将在移动设备查看器中显示省略号。在包含大量数据的项的移动编辑表单中,SharePoint Foundation 会对每个字段类型禁用字段编辑,以防在内容超过指定限制时丢失数据。在上述两种情况下,移动呈现限制都可以确定移动设备中显示的内容。
呈现限制不仅定义对用于移动控件的省略号呈现的文本长度限制,而且定义这些控件中显示的选项的数目。若要查看呈现限制及其默认值的列表,请参阅本主题结尾处的表。
配置限制的两种方式
通过下面两种方式之一确定呈现限制:
在可以编辑的移动 web.config 文件中设置服务器场范围的默认限制。
可通过 SPWeb 的 Properties 属性以编程方式覆盖每个网站的默认限制。子网站不能继承通过 Web 属性所做的修改。
修改移动 Web.config 文件
移动 web.config 中的每个限制设置都表示为该文件的 <appSettings> 部分中的键值对,例如,<add key="mobile_webtitlelimit" value="20" />。如果文本长度限制的配置设置为 0,或未指定任何项,则会关闭该键的省略号呈现功能。
备注
在修改移动 web.config 文件时,必须在 SharePoint Foundation 部署中的每台前端 Web 服务器上执行此操作。
用此对象模型替代每个网站的默认值
若要允许对每个网站的呈现限制进行自定义,SharePoint Foundation 首先要确定 SPWeb 对象的属性包(Properties 属性)是否存储了呈现限制参数。如果是,则属性包存储的值将指定呈现限制;否则,存储在 web.config 中的值将指定呈现限制。因此,针对特定网站的属性包设置将会替代移动 web.config 中的服务器场设置。
若要更改移动控件的呈现限制,请向 Properties 属性中的属性包 (SPPropertyBag) 对象添加属性。下面的示例演示如何将特定网站的列表标题的呈现限制更改为 256 个字符。
SPWeb webSite = SPContext.Current.Site.AllWebs["MyWebSite"];
webSite.Properties["mobile_listtitlelimit"] = "256";
webSite.Properties.Update();
Dim webSite As SPWeb = SPContext.Current.Site.AllWebs("MyWebSite")
webSite.Properties("mobile_listtitlelimit") = "256"
webSite.Properties.Update()
该示例需要对 Microsoft.SharePoint 和 Microsoft.SharePoint.Utilities 命名空间使用 using 指令(在 Visual Basic 中为 Imports)。
呈现限制
下表介绍在移动页中使用的呈现限制参数,并显示了它们的默认最大值。度量单位为字符(不分半角字符或全角字符)。
名称 |
说明 |
值 |
---|---|---|
基本呈现限制 |
|
|
mobile_basetextlengthlimit |
文本长度的基本限制 |
1024 |
系统呈现限制 |
|
|
mobile_peoplesearchresultlimit |
搜索人员时返回的项数限制 |
50 |
mobile_maximumimagesize_kilobyte |
图像大小限制(以 KB 为单位) |
100 |
mobile_enablelimitationondispform |
位于显示表单上的省略号呈现的标志 |
FALSE |
mobile_fieldnumberlimitforinputform |
对要显示在"新建"和"编辑"表单上的字段数的限制 |
100 |
mobile_fieldtitlelimit |
对表单上每个字段标题的限制 |
1024 |
mobile_itemtitlelimit |
对表单上显示的项标题的限制 |
1024 |
mobile_listtitlelimit |
对列表视图上列表标题的限制 |
1024 |
mobile_viewitemnumberlimit |
对要显示在列表视图上的项数的限制 |
1000 |
mobile_viewnumberlimit |
对要在视图下拉列表中显示的视图数的限制 |
20 |
mobile_viewtitlelimit |
对视图下拉选择器中视图名称长度的限制 |
1024 |
mobile_webtitlelimit |
对网站的顶级网页上显示的网站标题长度的限制 |
1024 |
字段相关限制 |
|
|
mobile_attachmentsfieldnumberlimit |
对要显示的附件数的限制 |
20 |
mobile_attachmentsfieldtextlimit |
对单个附件的文件名长度的限制 |
1024 |
mobile_calculatedfieldtextlimit |
对计算字段的字段值长度的限制 |
1024 |
mobile_choicefieldoptionnumberlimit |
对要显示在"新建"和"编辑"表单上的选项字段的选项数的限制 |
20 |
mobile_choicefieldoptiontextlimit |
对"新建"和"编辑"表单上的选项字段的任何单一选项名称的限制 |
1024 |
mobile_fieldtextlimitforview |
对列表视图上的任何单一字段值长度的限制 |
1024 |
mobile_filefieldtextlimit |
对文件字段的字段值长度的限制 |
1024 |
mobile_lookupfieldoptionnumberlimit |
对要显示在"新建"和"编辑"表单上的查阅字段的选项数的限制 |
20 |
mobile_lookupfieldoptiontextlimit |
对"新建"和"编辑"表单上的查阅字段的任何单一选项名称的限制 |
1024 |
mobile_multichoice_displaylimitforselectedchoices |
对要显示在列表视图和项目显示表单上的多选项字段中的选定选项数的限制 |
20 |
mobile_multilinetextfieldtextlimit |
对多行文本字段的字段值长度的限制 |
2048 |
mobile_multilookup_displaylimitforselectedlookups |
对要显示在列表视图和项目显示表单上的多值查阅字段中的选定查阅值数的限制 |
20 |
mobile_multiuser_displaylimitforselectedusers |
对要显示在列表视图和项目显示表单上的多用户字段中的选定用户数的限制 |
100 |
mobile_singlelinetextfieldtextlimit |
对单行文本字段的字段值长度的限制 |
1024 |
mobile_urlfieldtextlimit |
对 URL 字段的文本长度的限制(URL 本身不显示,也不会被截断) |
1024 |
mobile_userfieldoptionnumberlimit |
对要显示在"新建"/"编辑"表单上的用户字段选项数的限制 |
20 |
mobile_userfieldoptiontextlimit |
对用户字段的任何单一选项长度的限制 |
1024 |