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

  • 發行項

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

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

摘要

Web.config 檔案會定義 ASP.NET 應用程式的行為。 Microsoft .NET Framework，包括 ASP.NET，會使用 XML 格式的 .config 文字檔來設定應用程式。 這與傳統登錄和Metabase設定機制有關。 目前沒有 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 檔案時，必須將該組態專案巢狀於複製來源的相同元素中。 若要判斷組態專案所包含 之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 檔案和所有子資料夾的資料夾。

參考資料