configuration 項目 (一般設定結構描述)
Common Language Runtime 和 .NET Framework 應用程式所使用之每一個組態檔中的必要根項目 (Root Element)。
<configuration xmlns="schema URL">
<!-- configuration settings -->
</configuration>
屬性和項目
下列章節會說明屬性、子項目和父項目。
屬性
屬性 |
描述 |
|---|---|
xmlns |
選擇性 String 屬性。 指定用來驗證組態檔之 XML 結構描述的 URL。 如果沒有設定此屬性，您就無法在 Microsoft Visual Studio 中使用 F1 說明開啟組態項目的主題。 ASP.NET 2.0 版的預設值為 "https://schemas.microsoft.com/.NetConfiguration/v2.0"。 |
子項目
項目 |
描述 |
|---|---|
configSections |
指定組態區段和命名空間宣告。 |
appSettings |
包含自訂應用程式的設定，例如檔案路徑、XML Web 服務 URL，或是儲存在應用程式 .ini 檔內的任何資訊。 |
connectionStrings |
針對 ASP.NET 應用程式和功能，指定資料庫連接字串集合 (做為名稱/值的配對)。 |
location |
指定要套用子組態設定的資源。 這個項目也是鎖定的組態設定，可以防止設定遭到子組態檔案覆寫。 |
指定 ASP.NET 組態結構描述中的所有項目。 |
|
指定啟始設定結構描述中的所有項目。 |
|
指定執行階段設定結構描述中的所有項目。 |
|
指定遠端設定結構描述中的所有項目。 |
|
指定網路設定結構描述中的所有項目。 |
|
指定密碼編譯設定結構描述中的所有項目。 |
|
指定組態區段設定結構描述中的所有項目。 |
|
指定追蹤和偵錯設定結構描述中的所有項目。 |
|
指定 Web 服務設定結構描述中的所有項目。 |
父項目
無。
備註
configuration 項目是 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的必要根項目。
每個組態檔必須剛好有一個 configuration 項目。
預設組態
下列程式碼範例示範任何 ASP.NET 應用程式都可以建立的基本 Web.config 檔。 檔案中提供了 customErrors 區段以供需要時使用，但此區段已標記為註解。
<?xml version="1.0"?>
<configuration
xmlns="https://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>
項目資訊
組態區段處理常式 |
不套用。 |
組態成員 |
|
可設定的位置 |
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 |
請參閱
工作
Accessing ASP.NET Configuration Settings
參考
connectionStrings 項目 (ASP.NET 設定結構描述)
概念
ASP.NET Configuration Overview
Format of ASP.NET Configuration Files