SharePoint 中的幻像页面无法呈现

应用对象
SharePoint Server 2019 SharePoint Server 2016 SharePoint Foundation 2013 SP1 Microsoft SharePoint Foundation 2010 Service Pack 2

症状

安装以下更新之一后,Microsoft SharePoint 中的某些幻像页面无法呈现:

例如,Microsoft Identity Manager (MIM) 门户页面和通过 SharePoint 解决方案部署的某些自定义页面无法呈现。

此外,你还可能遇到一个或多个以下场景。

方案 1

被阻止的幻像页面显示以下错误消息之一:

注意

  • 此页面不允许使用属性“autoeventwireup”。

  • 此页面不允许使用属性“enablesessionstate”。

  • 该文件中不允许使用代码块。

  • 此页中不允许使用事件处理程序“OnSelectedIndexChanged”。

    注意 最后一条错误消息中的事件也可能是其他事件,例如“OnClick”。

方案 2

被阻止的幻像页面显示以下错误消息:

注意

UnsafeControlException:无法显示或导入此页上的 Web 部件或 Web 窗体控件。 找不到类型或未注册为安全类型。

方案 3

被阻止的幻像页面显示以下错误消息:

注意

此页面上不允许使用引用的文件 '/_layouts/somedirectory/affectedusercontrol.ascx'。

原因

虚影页存储在文件系统中。 通过禁止服务器端脚本和不安全的控制来增强其安全级别。 如果满足以下条件,可能会阻止虚影页面呈现:

  • 幻像页面包含内联代码或服务器端脚本。
  • 代码隐藏类型或 Web 部件类型未注册为安全类型。

场景 1 的解决方案

若要解决此问题,请将具有 VirtualPath 属性的新 PageParserPath 元素添加到 configuration/SharePoint/SafeMode/PageParserPaths 元素下的 Web.config 文件。

例如,您可能会收到下面的错误消息:

“此页面不允许使用属性 'autoeventwireup'。”

在这种情况下,你可以添加一个 PageParserPath 元素,如下所示:


<SafeMode MaxControls="200" CallStack="false" DirectFileDependencies="15" TotalFileDependencies="250" AllowPageLevelTrace="false">
    <PageParserPaths>
        <PageParserPath VirtualPath="/<relativepath>/page.aspx" CompilationMode="Always" AllowServerSideScript="true" AllowUnsafeControls="true"/>
    </PageParserPaths>
</SafeMode>

如果必须取消阻止同一虚拟目录中的所有页面,则可以使用 PageParserPath 元素,如下所示:


<SafeMode MaxControls="200" CallStack="false" DirectFileDependencies="15" TotalFileDependencies="250" AllowPageLevelTrace="false">
    <PageParserPaths>
        <PageParserPath VirtualPath="/<relativepath>/*" CompilationMode="Always" AllowServerSideScript="true" AllowUnsafeControls="true" IncludeSubFolders="True"/>
    </PageParserPaths>
</SafeMode>

注意

  • VirtualPath 是阻止页的路径。
  • VirtualPath 必须引用已虚影且不能被任何用户取消托管的页面,或包含此类页面的目录。
  • VirtualPath 必须引用不引用其他页面或可取消托管的母版页,或不包含此类页面或母版页的目录。
  • DirectFileDependencies 指示允许的直接文件依赖项的数量。 如果收到错误消息,例如“允许的直接文件依赖项数超出限制”,请更改此值。

场景 2 的解决方案

若要解决此问题,请将给定类型、命名空间和程序集强名称的新 SafeControls 元素添加到 configuration/SharePoint/SafeControls 元素下的 Web.config 文件中,如 SafeControls 元素 (Solution) 中所述。 然后,将 Safe 属性设置为 TRUE。

有关 SafeControls 元素中属性值格式的详细信息,请参阅如何:将控件标记为安全控件的“在包设计器中标记安全控件”部分的步骤 12 中的表。

场景 3 的解决方案

若要解决此问题,请将使用 Src 属性的新 SafeControls 元素添加到 configuration/SharePoint/SafeControls 元素下的 Web.config 文件中。

例如,您可能会收到下面的错误消息:

“此页面上不允许使用引用的文件 '/_layouts/somedirectory/affectedusercontrol.ascx'。”

在这种情况下,可以添加 SafeControls 元素,如以下示例所示:


< SafeControls>
    <SafeControl Src="~/_layouts/somedirectory/*" IncludeSubFolders="True" Safe="True" AllowRemoteDesigner="True" SafeAgainstScript="True" />
</SafeControls>

< SafeControls><SafeControl Src=“~/_layouts/somedirectory/*” IncludeSubFolders=“True” Safe=“True” /></SafeControls>