建立 ASP.NET 應用程式的 Web.config 檔案

本文說明如何建立用來控制個別 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> 新增大部分的 ASP.NET 組態 </system.web> 設定。 這些行會標示 ASP.NET 組態設定的開頭和結尾。

參考資料