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

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

<configuration xmlns="schema URL">
   <!-- configuration settings -->
</configuration>

屬性和項目

下列小節描述屬性、子項目和父項目。

屬性

屬性 描述

xmlns

選擇性 String 屬性 (Attribute)。

指定用來驗證組態檔之 XML 結構描述的 URL。如果沒有設定此屬性,您就無法在 Microsoft Visual Studio 中使用 F1 說明開啟組態項目的主題。

ASP.NET 2.0 版的預設值為 "http://schemas.microsoft.com/.NetConfiguration/v2.0"

子項目

項目 描述

configSections

指定組態區段和命名空間宣告。

appSettings

包含自訂應用程式的設定,例如檔案路徑、XML Web 服務 URL,或是儲存在應用程式 .ini 檔內的任何資訊。

connectionStrings

針對 ASP.NET 應用程式和功能,指定資料庫連接字串集合 (做為名稱/值組)。

location

指定要套用子組態設定的資源。這個項目也是鎖定的組態設定,可以防止設定遭到子組態檔案覆寫。

ASP.NET 設定結構描述

指定 ASP.NET 組態結構描述中的所有項目。

啟始設定結構描述

指定啟始設定結構描述中的所有項目。

執行階段設定結構描述

指定執行階段設定結構描述中的所有項目。

遠端設定結構描述

指定遠端設定結構描述中的所有項目。

網路設定結構描述

指定網路設定結構描述中的所有項目。

密碼編譯設定結構描述

指定密碼編譯設定結構描述中的所有項目。

組態區段結構描述

指定組態區段設定結構描述中的所有項目。

追蹤和偵錯設定結構描述

指定追蹤和偵錯設定結構描述中的所有項目。

XML Web Service 設定結構描述

指定 Web 服務設定結構描述中的所有項目。

父項目

無。

備註

configuration 項目是 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的必要根項目。

每個組態檔必須剛好有一個 configuration 項目。

預設組態

下列程式碼範例示範任何 ASP.NET 應用程式都可以建立的基本 Web.config 檔。檔案中提供了 customErrors 區段以供需要時使用,但此區段已標記為註解。

<?xml version="1.0"?>
<configuration 
   xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">
    <appSettings/>
    <connectionStrings/>
    <system.web>
        <compilation debug="false"/>
        <authentication mode="Windows"/>
        <!--
        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
            <error statusCode="403" redirect="NoAccess.htm"/>
            <error statusCode="404" redirect="FileNotFound.htm"/>
        </customErrors>
        -->
    </system.web>
</configuration>

項目資訊

組態區段處理常式

不套用。

組態成員

Configuration

可設定的位置

Machine.config

根層次的 Web.config

應用程式層級的 Web.config

虛擬或實體目錄層級的 Web.config

需求

Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版

.NET Framework 1.0、1.1 或 2.0 版

Microsoft Visual Studio 2003 或 Visual Studio 2005

請參閱

工作

HOW TO:以程式設計方式存取 ASP.NET 組態設定

參考

configSections 項目 (一般設定結構描述)
appSettings 項目 (一般設定結構描述)
connectionStrings 項目 (ASP.NET 設定結構描述)
location 項目 (ASP.NET 設定結構描述)

概念

ASP.NET 組態概觀
保護 ASP.NET 組態
編輯 ASP.NET 組態檔
ASP.NET 組態案例

其他資源

一般組態設定 (ASP.NET)
ASP.NET 組態設定
設定 ASP.NET 應用程式
ASP.NET 組態 API
組態檔