本文說明如何建立 用來控制個別 ASP.NET 應用程式行為的 Web.config 檔案。
原始產品版本: ASP.NET
原始 KB 編號: 815179
摘要
Microsoft .NET Framework,特別是 ASP.NET,會使用 XML 格式的 .config 檔案來設定應用程式。 這種做法與傳統的登錄和 Metabase 組態機制背道而去。 目前沒有 Microsoft Management Console (MMC) 嵌入式管理單元或其他Microsoft提供的管理工具,可用來建立及修改 .config 檔案。
.config 檔案的階層
.NET Framework 依賴 .config 檔案來定義組態選項。 .config 檔案是以文字為基礎的 XML 檔案。 多個 .config 檔案通常存在於單一系統上。
.NET Framework 的系統範圍組態設定定義於Machine.config 檔案中。 Machine.config 檔案位於 %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ 資料夾中。 您可以修改 Machine.config 檔案中包含的預設設定,以影響整個系統上Microsoft .NET 應用程式的行為。
如果您在應用程式的根資料夾中建立 Web.config 檔案,則可以變更單一應用程式的 ASP.NET 組態設定。 當您這樣做時,Web.config 檔案中的設定會覆寫 Machine.config 檔案中的設定。
建立 Web.config 檔案
您可以使用記事本等文字編輯器來 建立 Web.config 檔案。 您必須在 ASP.NET 應用程式的根目錄中建立名為 Web.config 的文字檔。
Web.config 檔案必須是格式正確的 XML 檔,而且格式必須與檔案類似%SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config。
Web.config 檔案必須只包含覆寫 Machine.config 檔案中設定之組態項目的專案。 Web.config 檔案至少必須有 <configuration> 元素和 <system.web> 元素。 這些專案將包含個別的組態專案。
下列範例顯示最小的 Web.config 檔案:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.web>
</system.web>
</configuration>
Web.config 檔案的第一行會將檔描述為 XML 格式,並指定字元編碼類型。 所有 .config 檔案的這一行必須相同。
後面的行會標示元素的<configuration>開頭和結尾,以及 <system.web> Web.config 檔案的 元素。 這些行本身不會執行任何動作。 不過,這些行會提供一個結構,可讓您新增未來的組態設定。 您可以在和 </system.web> 行之間<system.web>新增大部分 ASP.NET 組態設定。 這些行會標示 ASP.NET 組態設定的開頭和結尾。