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 嚴格符合
Legacy 還原一些呈現變更,以符合 v1.1 呈現行為。

子項目

無。

父項目

項目

描述

configuration

Common Language Runtime 和基於 .NET Framework 的應用程式所使用之每一個組態檔中的必要根項目 (Root Element)。

system.web

在組態檔中,指定 ASP.NET 組態設定的根項目。 包含設定 ASP.NET Web 應用程式和控制該應用程式之行為方式的組態項目。

備註

只有在 Web.config 檔案中 pages 項目的 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 標準。 在 name 屬性中所發生的主要變更不再呈現於 <form> 標記上。

<xhtmlConformance mode="Strict"/>

項目資訊

Configuration Section Handler

XhtmlConformanceSection

Configuration Member

XhtmlConformance

Configurable Locations

Machine.config

根層次的 Web.config

應用程式層級的 Web.config

Web.config

Requirements

Microsoft Internet Information Services (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

參考

system.web 項目 (ASP.NET 設定結構描述)

configuration 項目 (一般設定結構描述)

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

.NET Framework Targeting for Web Projects

其他資源

一般組態設定 (ASP.NET)

ASP.NET 組態設定

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API