升级页

上次修改时间: 2010年4月6日

适用范围: SharePoint Foundation 2010

常规页升级

Microsoft SharePoint Foundation 2010 使用不同的策略对页进行升级,具体取决于是否已自定义该页。

SharePoint Foundation 跟踪用于创建网站的网站定义版本。如果网站具有更新定义,并且此更新定义将转换尚未自定义的前端网站定义文件,则可以通过更新定义来升级网站。在升级过程完成之后,将对未自定义的前端文件的任何引用从以前的目录映射到当前目录,即:

%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\

并非每个网站路径在初始升级时都会得到升级。不具有升级路径的任何现有网站定义仍将运行,但继续指向其原来的页面。同样,已经更新的网站也可能仍具有已自定义并存储在数据库中的早期版本的页面。

在分析并呈现页面时,SharePoint Foundation 确定与页面关联的网站,因此也将确定前端 Web 服务器上未自定义文件的版本。早期版本的页面不一定与当前版本的标准兼容。如果网站尚未升级,这些页面将在兼容模式下运行。如果尚未升级网站,则这些页将在兼容模式中运行,但在应用升级定义并升级网站之后,SharePoint Foundation 会假定页面与 Microsoft ASP.NET 3.5 完全兼容。这意味着这些页面具有 Web 部件管理器(如果它们包含 Web 部件区域),具有有效的控件标识符 (ID) 并与母版页关联。

页面兼容性

在早期版本 SharePoint Foundation 中,使用"Windows SharePoint Services"分析器对数据库中的已自定义页面进行分析,此分析器具有的容限与 ASP.NET 分析器的不同。如果页面包含格式不正确的标记语言(当页面在早期版本中工作时,可能出现此情况),由于分析器之间存在的差异,可能导致此页面在 ASP.NET 和当前版本的 SharePoint Foundation 中无法工作。

SharePoint Foundation 分析器可解决页标记中的部分已知的损坏问题,其中包括:

  • 与 ASP.NET 不兼容的无效的控件 ID,例如,当由于 ID 以数字或不受支持的字符开始而导致名称无效时,ID 是一个空字符串,或者 ID 对于页面上的其他 ID 不是唯一的。此修改可能会损坏页面,在此情况下,客户端脚本将依赖以前的 ID 名称。

  • 通过在 Web 部件上实现 SharePoint IAttributeAccessor 接口来处理由 SharePoint Foundation 插入到页面中的已知属性(例如,__Preview、__Error、__Web PartId、WebPart)。

  • Trace 属性的移除。

  • 添加适当的指令以便为诸如 <WebPart:WebPartZone> 或 <SharePoint:Theme> 之类的标记注册。

SharePoint Foundation 不会尝试修复页面上的以下损坏问题:

  • 控件上的未知属性。

  • 存在 <object runat=server> 标记。

  • 数据绑定表达式在属性 (<% ... %>) 内部呈现。

SharePoint Foundation 在数据库中为每个已自定义的页面存储一个版本整数。当浏览已自定义的页面时,SharePoint 将检查该页面的版本号。如果版本号对应于未升级的早期版本,则 SharePoint 将修复这些不同的损坏问题并在后台更新页面。

应用程序页

SharePoint Foundation 将布局文件存储在独立于语言的文件夹中,并自动设置一个将用户从以前的 /_layouts 位置导航到当前位置的重定向。

一般来说,布局页与通过 SPWeb.MasterUrl 属性设置的母版页相配。对于早期版本的网站定义,此属性应引用保留了早期外观的母版页。

Web 部件

早期版本的 SharePoint Foundation 的 Web 部件继续在当前版本中运行,尽管需要在配置中对它们进行一些更改。如果创建新的 Web 应用程序来承载 SharePoint Foundation 安装,则此安装的 web.config 文件必须进行更新,以包含其他安全控件和代码访问安全 (CAS) 策略设置。

尽管一般级别的 CAS 限制在 SharePoint Foundation 中保持不变,但已修改策略文件以使它们与 ASP.NET 匹配。为此,在当前版本的 SharePoint Foundation 中,它通常不能重用 CAS 策略文件。最佳选择是生成当前版本的 wss_minimaltrust.config 文件的副本,然后在必要时逐步添加权限。

有关如何升级 Web 部件的详细信息,请参阅升级 Web 部件

请参阅

概念

升级 Web 部件

其他资源

升级 SharePoint Foundation