共用方式為

編輯 ASP.NET 應用程式的組態

本文說明如何編輯 ASP.NET 應用程式的 Web.config 檔案。

原始產品版本： ASP.NET
原始 KB 編號： 815178

摘要

Web.config 檔案會定義 ASP.NET 應用程式的行為。 Microsoft .NET Framework，包括 ASP.NET，會使用 XML 格式的 .config 文本檔案來設定應用程式。 這與傳統的登錄和中繼基底組態機制背道而去。 目前沒有 Microsoft Management Console （MMC） 嵌入式管理單元或其他Microsoft提供的管理工具，可用來建立及修改 .config 檔案。

將組態設定新增至 Web.config

大部分 ASP.NET 應用程式都隨附預先建置 的 Web.config 檔案，可使用記事本等任何文本編輯器進行編輯。 一般而言， Web.config 檔案包含可編輯檔案自我解釋的批注。 不過，您可能必須將組態專案新增至 尚未定義組態專案的 Web.config 檔案。 若要將標準組態專案新增至 Web.config 檔案，請遵循下列步驟：

  1. 在 文本編輯器中開啟 Machine.config 檔案，例如記事本。

    Machine.config 檔案位於 %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ 目錄中。

  2. 在 Machine.config 檔案中，找出您想要在 Web.config 檔案中覆寫的組態設定。 當元素是一行以上時，元素會以一行開頭 <element_name> ，並以 結尾 </element_name>。 元素也可能是自我關閉，而且看起來可能類似 <element_name attribute1='option' attribute2='option' />。 會忽略空格符。 因此，元素可能會跨越多行。 元素前面可能會加上批注。 批註包含在標記內 <!-- and --> 。 <trace>接下來的組態專案範例是自我關閉專案的範例。 組 <trace> 態專案範例具有多個屬性、跨越多行，並在開頭有批注。

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output on individual pages
    requestLimit="[number]" - Number of trace results available in trace.axd
    traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
 -->
<trace
    enabled="false"
    localOnly="true"
    pageOutput="false"
    requestLimit="10"
    traceMode="SortByTime"
/>

  3. 將整個組態專案和任何開始批註複製到剪貼簿。

  4. 判斷元素在 Machine.config 檔案中的巢狀結構。

    Machine.config 檔案是階層式的，而且組態元素會巢狀於其他元素中。 當您將組態專案從 Machine.config 檔案複製到 Web.config 檔案時，您必須將該組態專案巢狀於複製的來源相同元素中。 若要判斷 Configuration 元素所包含的 Machine.config 檔案元素，請在 Machine.config 檔案中向上捲動，直到您找到已開啟且未關閉的項目為止。 內含專案很容易識別，因為較高層級的元素具有較少的縮排。

    大部分 ASP.NET 組態專案都包含在 元素中 <system.web> 。 元素 （ </system.web> ） 的結尾必須放在您的組態項目之後。

    注意

    組態專案所包含的專案。 您必須將該專案貼到 Web.config 檔案中的相同元素中。 組態專案可能巢狀於多個元素中。 您必須在 Web.config 檔案中建立所有較高層級的專案。

  5. 關閉 Machine.config 檔案，然後使用文字編輯器，在 ASP.NET 應用程式的根目錄中開啟 Web.config 檔案。

  6. 將組態專案貼到您在步驟 4 中識別之專案的開頭和結尾。

    例如，如果組態專案包含在 元素中 <system.web> ，則組態項目必須緊接在元素的開頭行和結尾行 <system.web> 之前貼上 </system.web> 。

  7. 修改 Web.config 檔案中的組態專案，以覆寫該應用程式的 Machine.config 設定。

    此設定適用於包含 Web.config 檔案和所有子資料夾的資料夾。

參考資料