xhtmlConformance 元素(ASP.NET 设置架构)
[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
配置符合 XHTML 1.0 的控件呈现。
<xhtmlConformance mode="Transitional|Legacy|Strict"/>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
特性 |
说明 |
---|---|
mode |
可选的 String 特性,该特性为 ASP.NET 应用程序指定 XHTML 呈现模式。 呈现模式可以是下表列出的其中一个值。 默认值为 Transitional (XHTML 1.0 Transitional)。
Value Description
Transitional XHTML 1.0 Transitional
Strict XHTML 1.0 Strict 一致性
Legacy 将为满足一致性而进行的大量呈现更改还原为 1.1 版呈现行为。
|
子元素
无。
父元素
元素 |
说明 |
---|---|
configuration |
公共语言运行时和基于 .NET Framework 的应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素。 包含各种配置元素,这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。 |
备注
只有在 Web.config 文件中页元素的 controlRenderingCompatibilityVersion 特性设置为 3.5 或网站针对 ASP.NET 3.5 或早期版本时,此设置才有效。 (有关如何将 ASP.NET 的特定版本确定为目标的信息,请参阅 .NET Framework Targeting for Web Projects。)否则,ASP.NET 将呈现 HTML,如同将 xhtmlConformance 设置设为 Strict,而不考虑实际 xhtmlConformance 设置。
controlRenderingCompatibilityVersion 特性设置为 3.5 或网站以 ASP.NET 3.5 或早期版本为目标时,默认 xhtmlConformance 模式是 Transitional。 但是,在某些情况下,您可能不希望 ASP.NET 呈现 XHTML 标记。 如果您的现有页面依赖于 XHTML 通常禁止的元素或特性时,一般会出现这种情况。 在这种情况下,您可以将 xhtmlConformance 模式设置为 Legacy。
备注
Legacy 模式不会将所有 HTML 呈现更改为它在 ASP.NET 1.1 中呈现方式。其行为由仅呈现可能破坏现有应用程序的更改还原为旧行为。没有还原所做的所有更改以符合 XHTML 规范的机制。
默认配置
下面的默认 xhtmlConformance 元素不是在计算机配置文件或根 Web.config 文件中显式配置的,而是由面向 .NET Framework 3.5 版或早期版本中的应用程序返回的默认配置。
<xhtmlConformance mode="Transitional"/>
示例
下面的代码示例将呈现模式切换为符合 XHTML 1.0 Strict 标准。 所进行的主要更改是:<form> 标记上不再呈现 name 特性。
<xhtmlConformance mode="Strict"/>
元素信息
Configuration Section Handler |
|
Configuration Member |
|
Configurable Locations |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config Web.config |
Requirements |
Microsoft Internet 信息服务 (IIS) 版本 6.0 Microsoft .NET Framework 2.0 版 Microsoft Visual Studio 2005 |
请参见
任务
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
参考
概念
ASP.NET Configuration File Hierarchy
.NET Framework Targeting for Web Projects